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Questo mese si risolve una grave anomalia... no, non stiamo 
parlando del conflitto di interessi, ma del fatto che ioProgram- 
mo ha finalmente il suo sito web! 

ioProgrammo è da molti anni la rivista di programmazione più 
venduta in Italia, ovviamente la speranza (convinzione?) è che 
il sito avrà lo stesso successo della rivista. La "missione" sarà 
quella che ci ha contraddistinto in tutti questi anni: essere uno 
strumento per chi programma "davvero". 
Rigore e praticità sono i punti car- 
dine della nostra idea di sviluppo, 
e tali rimarranno anche per il sito. 
Lì troverete articoli e contributi ori- 
ginali, anteprime e soprattutto un 
forum che sarà, ci auguriamo, il 
cuore pulsante del sito: un luogo 
dove scambiarsi opinioni e cono- 
scenze, e dove gli autori di ioPro- 
grammo saranno pronti a dialoga- 
re con voi e ad aiutarvi in caso di difficoltà. 
Il sito ha avuto una lunga gestazione ma riteniamo che, anche 
grazie al lavoro dell'ottimo Piero Mannelli, tutto il tempo che 
gli è stato dedicato sia stato ben speso. Come sempre, per 
domande, suggerimenti e critiche siamo sempre a vostra 
disposizione. 

RS. 

Scrivo queste note dal Tech Ed di Barcellona, edizione del 
decennale. Migliaia di sviluppatori e decine di sessioni tecni- 
che di cui troverete puntuale cronaca nel prossimo numero di 
ioProgrammo. Vi anticipo i temi: Web Services, sicurezza, sicu- 
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Windows Mobile 
2003 per Pocket PC 

Wi-Fi e multimedia al centro 
della nuova piattaforma 

La nuova versione di Windows 
Mobile è tutta tesa a semplificare 
e rendere più piacevole l'utilizzo del 
Pocket PC, attraverso un miglior sup- 
porto per l'accesso alle reti wireless, 
ai contenuti multimediali e ad una 
migliore integrazione con applicazio- 
ni e strumenti di sviluppo .NET. Il 
forte impegno di Microsoft è testimo- 
niato dagli investimenti compiuti nel 
lancio del nuovo brand "Windows 
Mobile" che accompagnerà una 
nuova generazione di prodotti e stra- 
tegie del gruppo. 
Secondo la consolidata filosofia 
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Microsoft, la nuova piattaforma 
offrirà nuove opportunità in primo 
luogo ai produttori Hardware e 
Software, e porterà vantaggi anche ai 
gestori e produttori di reti wireless 
che potranno fornire nuove soluzioni 
per migliorare il modo di lavorare 
degli utenti. 
Contestualmente al lancio della 




nuova piattaforma, sono stati presen- 
tati due nuovi partner che entro la 
fine dell'anno lanceranno nuovi dipo- 
sitivi: Gateway Inc. e JVC, che si 
vanno ad aggiungere alla lunga 
schiera di blasonati produttori. HP, 
Acer, Dell Toshiba, Fujitsu Siemens, 
Panasonic, sono solo alcuni dei nomi 
che stanno facendo grande il mercato 
dei Pocket PC. 

Vediamo i principali miglioramenti 
apportati al nuovo Windows Mobile 
2003: 





• Connessione semplificata alle reti 
wireless, attraverso il rilevamento 
automatico di reti Wi-Fi ed il 
supporto nativo a Bluetooth. 

• Una più efficace gestione della 
posta elettronica grazie alla 
integrazione con Microsoft 
Exchange Server 2003 (presto 
disponibile), che semplificherà i 
meccanismi di sincronizzazione 
della posta. 

• Una più avanzata sezione 
multimediale che renderà più 
immediato l'utilizzo di musica e 
foto sui palmari e che, attraverso 
Windows Media Player 9, farà 
della riproduzione di video ad 
alta qualità uno dei punti di forza 
dei Pocket PC. 

• Un più rapido turn over di nuove 
applicazioni, grazie al supporto 
integrato per il.NET Compact 
Framework, uno strumento che 
semplifica e velocizza lo sviluppo 
di nuovo software. 

Windows Mobile 2003 si presenta, 
dunque, come una ideale piattaforma 
per lo sviluppo di nuove applicazioni 
che potranno trarre grande vantaggio 
dal nuovo sistema operativo 
Windows CE .NET 4.2 e dal .NET 
Compact Framework disponibili 
direttamente in ROM. Attraverso gli 
strumenti di sviluppo di Visual 
Studio .NET 2003, milioni di svilup- 
patori possono utilizzare la loro espe- 
rienza e le loro conoscenze per svi- 
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luppare innovative applicazioni 
mobili. 

Un nuovo SDK per Windows Mobile 
2003 è disponibile gratuitamente pro- 
prio per permettere agli sviluppatori 
di fare questo salto verso il mobile. 

www.microsoft.com/nnobile /developer/ 



Java e Linux 
alla conquista 
del pianeta rosso 



Linux e Java alla conquista 
di Marte 

Entro dieci anni pronto un veicolo 
per l'esplorazione del pianeta 
rosso. James Gosling ha presentato 
alla JavaOne di San Francisco un pro- 
totipo destinato alla esplorazione 
della superficie di Marte. Uno dei fat- 
tori chiave in queste missioni è la 
risposta in real time delle apparec- 
chiature, che devono essere in grado 
di reagire senza esitazioni a qualsiasi 




sollecitazione. Il computer di bordo 
aveva infatti installato il sistema ope- 
rativo TimeSys Linux RTOS e la 
JTime Real Time Java Visual Machine. 
Un grosso passo avanti per Java che 
va a sostituirsi alle applicazioni 
C/C++ che hanno sempre dominato 
nel settore delle mission criticai. 
Mars Exploration Rover, questo il 
nome del veicolo, è nato dalla colla- 
borazione di Sun Microsystems con il 
Jet Propulsion Laboratory e sarà uti- 
lizzato nella missione Mars 
Expedition programmata per il 2009. 

www. java . su n . com 



Java incontra Python 

Jython fa breccia nel muro 
che divide i due linguaggi 

Nella comunità open source 
Python acquisisce sempre nuovi 
consensi, grazie alla sua semplicità e 
al fatto di essere rigorosamente object 
oriented e interpretato. Facile da 
imparare ed utilizzato ampiamente 
per lo scripting per Web Server ha 
dalla sua un forte supporto per XML 
e per la gestione delle immagini, ed è 
facile raggiungere risultati di rilievo 
con poche righe di codice. Quello che 
manca a Python è una reale diffusio- 
ne, soprattutto in ambito business. 
Ora è forse possibile un salto di qua- 
lità: Jython è un interprete Python 
100% pure Java, che consente di uti- 
lizzare le numerose librerie Python in 
progetti Java e, soprattutto, rende 
possibile la realizzazione di progetti 
misti, in cui è possibile affidare al lin- 
guaggio più adatto i compiti che di 
volta in volta vanno realizzati. 

www.jython.org 



Un server alla portata 
di tutti 

Da Dell un server di facile 
gestione ad un prezzo molto 
interessante 

La nota azienda, leader per la ven- 
dita diretta di computer e com- 
plete soluzioni informatiche, ha 
recentemente presentato un nuovo 




prodotto rivolto prevalentemente alle 
piccole imprese. Il Dell PowerEdge 
400SC è infatti un piccolo ma efficien- 
te sistema, semplice da installare e 
gestire, ideale per svolgere la funzio- 
ne di intranet server. E' possibile sce- 
gliere tra diverse configurazioni 
hardware, con CPU che vanno dal 
Celeron a 2 Ghz, fino al Pentium 4 a 
3,2 GHz. Ma la caratteristica davvero 
interessante rimane il prezzo, infatti 
il modello PowerEdge 400SC IDE 
(CPU Intel Celeron 2 GHz, 128 MB di 
RAM, HD IDE da 40 GB, scheda di 
rete Gigabit) viene proposto al prezzo 
di soli a 399 (iva e trasporto esclusi). 

www.dell.it 



A Francoforte 
vince Windows 

Dopo il duro colpo di 
Monaco di Baviera, 
Microsoft si prende 
una rivincita sull'open 
source in tre città europee, 
fra cui Francoforte 

Microsoft annuncia di aver vinto 
tre contratti governativi in 
altrettante grandi città europee, con 
lo scopo di spegnere l'entusiasmo con 
cui la comunità open source aveva 



http://www.ioprogrammo.net 



3 ►►► 7 



w 



accolto, lo scorso maggio, la decisione 
del comune di Monaco di Baviera di 
migrare i propri sistemi informatici 
da Windows a Linux. Gli accordi per- 
metteranno a Microsoft di installare 
su centinaia di computer dei comuni 
di Francoforte (Germania), Riga 
(Lettonia) e Turku (Finlandia) versio- 
ni desktop e server di Windows. 
Nonostante il dominio di Microsoft 
nel mercato aziendale e governativo 
in Europa, nell'ultimo periodo le 
soluzioni provenienti dal mondo del 
software open source si sono molti- 
plicate e sono riuscite, in vari casi, a 
spuntare alcune importanti commes- 
se. Per questo, la vittoria in queste tre 
città appare significativa. 

www.microsoft.it 



Desktop Firewall 8.0 

Una soluzione per la difesa 
dei desktop che include 
tecnologie di rilevamento 
delle intrusioni 
e funzionalità di firewall 
per pacchetti e applicazioni 

McAfee Desktop Firewall 8.0 con- 
sente agli utenti enterprise di 
proteggere client remoti e fissi da 
minacce come codici maligni, hacker 
e applicazioni non autorizzate. 
Il software include una nuova funzio- 
ne di monitoraggio delle applicazioni 
per prevenire l'installazione o l'ese- 
cuzione di applicazioni non autoriz- 
zate. È disponibile inoltre una nuova 
modalità di quarantena che consente 
ad ePolicy Orchestrator di ispeziona- 
re il client prima che questo si colle- 
ghi alla rete. 



Se l'antivirus del client è obsoleto o il 
firewall usa policy datate, l'accesso 
alla rete viene limitato. 
La soluzione è già disponibile per le 
piattaforme Microsoft Windows 98 
Se, Me, Nt 4.0, 2000 e Xp. 




www.mcafeesecurity.conn. 



Districarsi 
fra le patch 



Disponibile una guida da 
Microsoft per muoversi con 
disinvoltura fra le centinaia 
di aggiornamenti e patch 
disponibili 

Microsoft ha pubblicato la prima 
versione della Guide to 
Security Patch Management, una 
guida che, come si legge sul sito, for- 
nisce informazioni concise, suggeri- 
menti, strumenti e template per aiuta- 
re le aziende a gestire, pianificare e 
applicare le patch di sicurezza sotto 
Windows 2000, XP e Server 2003. 
La guida è disponibile solo in lingua 
inglese. 

www.nnicrosoft.conn/downloads/ 



Apple presenta 
Safari 1.0 



Apple ha annunciato 
l'introduzione sul mercato 
di Safari 1.0, a 
completamento del 
programma beta di ampio 
successo che ha fatto 
registrare quasi cinque 
milioni di download dal 
7 gennaio 2003, data 
del lancio 

Safari è diventato il browser prefe- 
rito da milioni di utenti Mac e 
sarà il browser di default su tutti i 
nuovi computer Macintosh, a partire 
da Power Mac G5 annunciato oggi. 
Apple ha anche rilasciato un kit per 
lo sviluppo di software che consente 
agli sviluppatori di integrare il moto- 
re di rendering HTML di Safari diret- 
tamente nelle proprie applicazioni. 
Safari, il browser web più veloce mai 



creato per piattaforme Mac, porta 
una sferzata di energia alla categoria, 
grazie a innovazioni quali capacità di 
ricerca su Google integrate diretta- 
mente nella barra degli strumenti, 
SnapBack, un nuovo modo per torna- 
re indietro all'istante ai risultati di 
una ricerca o al livello superiore di 
qualsiasi sito web dopo aver navigato 
nei livelli inferiori, un innovativo 
metodo per denominare, organizzare 
e presentare i preferiti, "tabbed brow- 
sing" e il blocco automatico delle 
finestre pubblicitarie a comparsa 
("pop-up"). 

"Safari ha rinvigorito il settore dei 
browser introducendo funzionalità 
innovative che regalano la migliore 
esperienza web su qualsiasi piattafor- 
ma", ha dichiarato Steve Jobs, CEO di 
Apple. "Ogni utente Mac dovrebbe 
eseguire subito il download di Safari 
per unirsi ai milioni di utenti che lo 
stanno già usando". 

www.apple.com 



Lettore MP3/WMA 
e flash drive BenQ 
Joybee 120 

Piccole dimensioni, massimo 
divertimento 

BenQ presenta Joybee 120, il 
secondo dispositivo della serie 
MP3 BenQ Joybee. Con dimensioni 
compatte: 57 x 38 x 11,5 mm, Joybee 
120 aggiunge un "tocco" di 
divertimento alla vita digitale grazie 
alle innumerevoli funzioni: MP3, 
WMA, stereo FM, registrazione 
vocale, FM e inoltre capacità flash 
drive USB. Piccolo nelle dimensioni, 
grande nel divertimento. 
La dimensione ridotta e la 
compattezza del Joybee 120 insieme 
alla lunga durata delle batterie (~16 
ore) sono caratteristiche progettate 
per chi è sempre in movimento. 
La batteria agli ioni di litio e la pratica 
ricarica tramite una connessione USB 
a qualsiasi PC fanno del Joybee 120 il 
compagno perfetto da portare sempre 
con sé. 

Il Joybee 120 ha in dotazione il 
software Q-Music di BenQ che 
permette di gestire facilmente la 
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musica che si preferisce e di 
modificarla secondo il proprio gusto, 
diventando un vero DJ. Il Joybee 120 
consente inoltre di memorizzare fino 
a 60 brani MP3 da 4 MB circa, mentre 
il registratore incorporato può 
imprimere oltre 1000 minuti di audio, 
risultando una soluzione perfetta per 
riunioni, lezioni e annotazioni vocali. 
Dispone inoltre di firmware 
aggiornabile per consentire agli utenti 
di essere sempre al passo con le 
ultime novità del mercato. 




Esprimi il tuo stile scegliendo tra uno 
dei tre straordinari colori disponibili: 
ghiaccio, verde e rosso bruciato. 
Ora la vita digitale sarà veramente a 
colori. Il prezzo del Joybee 120 da 
64MB è di euro 149 mentre quello da 
128Mb è di 169. 

www.benq.it 



IIYAMA presenta 
la nuova gamma 
di LCD entry level 

Due modelli con un nuovo 
design e assai completi dal 
punto di vista funzionale: 
pannelli dell'ultima 
generazione, veloci e 
luminosi, casse integrate, 
adatti per l'ufficio, così 
come per il gioco e le 
immagini in movimento 

Con il lancio dell 7 E380S, lcd 15", si 
completa la nuova linea entry 
level di IIYAMA: una linea con un 
nuovo design molto accattivante, 
presentata in tre varianti colore 
(bianco, nero e Silver /antracite). 
Anche le prestazioni sono 



estremamente interessanti: la matrice 
TN+Film consente di ottenere 
un'ottima luminosità sia per il 15" 
che per il 17" e offre un contrasto 
elevato e un angolo di visione che 
garantisce grande confort di utilizzo. 






Entrambi i monitor prevedono la 
possibilità di impostare le modalità di 
risparmio energetico Eco 1 ed Eco 2: 
livelli ridotti di luminosità 
consentono di abbassare il consumo 
elettrico durante l'uso, di allungare la 
vita utile delle lampade ed ottenere 
un comfort di lavoro con tonalità di 
colore e flussi di luce meno 
aggressivi. U E380S offre la funzione 
OPQ (Optimal Picture Quality) che 
consente, con la semplice pressione 
dell'apposito tasto in facciata, di 
variare luminosità e contrasto su una 
scala ottimizzata per la fruizione di 
immagini statiche, grafiche e per 
immagini in movimento. UE380S ha 
le casse integrate ed è compatibile PC, 
Mac e workstation. Il prezzo al 
pubblico è di Euro 359,00 I.V.A. 
inclusa. 

http://www.iiyama.it 



SAGEM integra 
la tecnologia Java 
nei propri Telefoni 
Cellulari 



Sagem, annuncia dei aver 
concluso il processo di 
integrazione della 
tecnologia Java nei propri 
telefoni cellulari 



L 



/ annuncio, rilasciato al termine 
di un periodo di ricerca e 



sviluppo congiunto tra SAGEM e Sun 
Microsystems, ha portato ad una 
completa integrazione della 
tecnologia JTWI (Java Technology for 
the Wireless Industry) negli apparati 
mobile della casa francese. 
I telefoni cellulari SAGEM che 
integreranno la tecnologia JTWI, 
disporranno di tutte le funzioni Java 2 
Platform Micro Edition (J2ME) 
Connected Limited Device 
Configuration (CLDC), Mobile 
Informati on Device Profile (MIDP 2.0), 
WMA e MMAPI. 

Questa nuova piattaforma consentirà 
ai clienti SAGEM di avere accesso, 
grazie ad un ambiente aperto e 
standardizzato, sia ad applicazioni 
preinstallate o scaricabili, come i 
giochi, che a numerose altre 
applicazioni professionali o personali. 
La tecnologia JTWI ri-definisce tutte 
le tappe principali legate alla 
prossima generazione di terminali 
Java. 

I/iniziativa "Java Technology for the 
Wireless Industry" (JTWI), lanciata nel 
settembre 2002, è ormai entrata in una 
fase di sviluppo avanzata e 
accompagnerà i lanci di terminali 
compatibili JTWI. U iniziativa JTWI 
conferisce una definizione chiara 
degli standard industriali e garantisce 
uno sviluppo costante della 
piattaforma destinata agli 
sviluppatori, consentendo agli 
operatori di lanciare più servizi legati 
alla trasmissione di dati e offrendo 
agli utilizzatori un ambiente più 
completo. 

Integrando la versione 2.0 di MIDP 
nei propri prodotti, SAGEM utilizza 
l'ultima evoluzione degli standard 
Java per i telefoni cellulari, 
aumentando così la potenza e la 
portata delle applicazioni create per i 
telefoni cellulari: questa nuova 
versione dello standard Java migliora 
l'interfaccia utente, fornisce il 
supporto di funzioni sonore evolute, 
un'interfaccia di gioco che migliora le 
funzioni grafiche, la connettività 
all'Internet Mobile, e molte altre 
possibilità associate e funzioni che 
consentano di proteggere gli scambi e 
l'esecuzione delle applicazioni 
scaricabili. 

http://www.sagem.com 
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JBuilder 9 Personal 




Da Borland, la soluzione leader per lo sviluppo Java 



Di ambienti di sviluppo per applicazio- 
ni Java se ne trovano veramente di 
tutti i tipi, ed ognuno di noi ha il suo pre- 
ferito, che può variare anche a seconda del- 
la complessità del progetto nel quale si è 
impegnati. Quello trattato in questo artico- 
lo, che trovate in versione di prova allega- 
to al CD-Rom della rivista, è uno tra i più 
imponenti e completi mai proposti, e va a 
rinnovare il concetto di programmazione 
in ambiente Java secondo la Borland. Sicu- 
ramente si tratta di un prodotto complesso, 
impegnativo per l'utente e per il sistema, 
che promette però enormi vantaggi sui 




tempi e le modalità di sviluppo, al prezzo 
di una curva di apprendimento delle fun- 
zionalità dello strumento piuttosto ripida. 
Ma scendiamo più nel dettaglio, analizzan- 



do quali sono le caratteristiche di punta del 
prodotto, e quali le novità che lo differen- 
ziano dal suo predecessore e dalle diverse 
versioni della stessa release. 
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public class Frarnel extends JFrame { 
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J Panel contentPane; 
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EorderLayout borderLayoutl = new BorderLayout( ) ; 
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Fig. 1: Installazione. 



Fig. 2: Schermata principale 
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QPer programmare un'interfaccia 
utente, il primo passo consiste nel 
creare un file che consenta questo tipo di 
operazione. 

Nella finestra che si apre quando selezio- 
nate File/ New, indicate Frame come tipo 
di file da creare, oppure un altro dei file 
che possono contenere interfacce grafi- 
che. 




BUna volta in possesso del file in cui 
costruire l'interfaccia è necessario se- 
lezionare il pannello Design per poter inizia- 
re a modellare l'interfaccia utente. Sulla 
parte superiore del programma sono pre- 
senti diversi pannelli carichi di oggetti da 
inserire nella propria applicazione è suffi- 
ciente selezionarli e tracciare un'area sulla 
maschera dell'applicazione. 



HUna volta creata l'interfaccia utente, 
se ne possono selezionare e modifi- 
care i componenti. Per selezionare un com- 
ponente presente, si deve agire sull'albero 
collocato alla sinistra del programma, 
mentre, una volta selezionato, se ne pos- 
sono modificare le proprietà impostandole 
direttamente nel pannello collocato alla 
destra. 
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L'AMBIENTE 
DI SVILUPPO 

L' ambiente di sviluppo integrato (IDE) 
JBuilder 9 si compone, come nel più clas- 
sico dei sistemi software, di una finestra 
che contiene diverse aree dedicate alle 
possibili attività operabili sul progetto. 
Scrivere codice, disporre oggetti in ma- 
niera visuale, navigare tra i file di proget- 
to e in un file in particolare, lanciare V ap- 
plicazione, eseguire il debbugging, com- 
pilare e creare V applicativo è possibile 
senza lasciare mai l'interfaccia principale. 
Ma se cercavate un software leggero e im- 
mediato per modificare uno o due file ja- 
va, vi accorgerete subito che questo non è 
lo strumento più adatto. Infatti tutto o 
quasi in JBuilder ruota attorno ai progetti 
che è necessario creare per accedere alle 
funzionalità avanzate, che sono la vera 
forza del prodotto. Per quel che riguarda 
l'area di text-editing, troverete tutte le 
funzionalità a cui i migliori programmi di 
sviluppo software vi hanno abituato, ed 
anche molto di più: possibilità di confi- 
gurare completamente sia V evidenziazio- 
ne della sintassi, così come ogni parame- 
tro dell' editor, scorciatoie da tastiera, for- 
mattazione automatica del codice, com- 
pletamento del testo, visualizzazione dei 
javaDocs e degli errori in linea, possibilità 
di utilizzo di template personalizzati 
nonché funzioni avanzate di ricerca e 
stampa. Per quanto riguarda la program- 
mazione visuale di interfacce utente, so- 
no presenti numerosi componenti, dai 
più utilizzati e conosciuti fino a quelli di 



presentazione di dati e connessioni ai da- 
tabase, con la possibilità di configurare 
completamente e visivamente ogni para- 
metro dell' oggetto in questione e di inte- 
grare facilmente fra loro le varie parti per, 
costruire strutture complesse di interazio- 
ne con l'utente. Tra l'altro sono presenti 
funzioni per la creazione, in modo intuiti- 
vo, di menu per le maschere dell'applica- 
zione. Non meno utile risulta a livello di 
documentazione, la creazione automatica 
dei java-doc relativi alle classi ed alle fun- 



zioni create, che automatizza un processo 
troppo spesso trascurato della program- 
mazione. Ma se lavorate in team, i soli ja- 
va-doc potrebbero non bastarvi per tene- 
re aggiornata e sotto controllo la situazio- 
ne, e quindi ecco il pieno supporto a fun- 
zioni che visualizzano le informazioni 
sullo stato di modifica e di revisione di un 
file , nonché a prodotti di orientati allo 
sviluppo in gruppo come Microsoft Vi- 
sual SourceSafe, Rational ClearCase ed 
altri. 
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QuervResolver 


Explores the basic resolver functionality 
provided by the DataExpuess package. 




ResolverEvents 


Demonstrates events that occurwhen 
resolving changes back te a (database) 
data source, and howto use these events 
to customize resolver event processing. 




ServerSpecificProcedures 


Demonstrates the use of the DataExpress 
ProceduueDataSet and 
ProceduceProvidec components to 
utilizo stored procedures on an SQL server. 




StreamableDataSets 


Demonstrates distributed computing using 
RMI and streamable data sets. This 
example also shows howto write 
customized Providers and Resolvers. 




TextDataFile 


Sample application that explores basic 
database concepts and JBuilder's 
DataExpress architecture without the need 
for a remote database. 
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Fig. 3: Documentazione. 



Supporto ai dati 
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Q JBuilder fornisce, oltre che le normali 
forme di connessione ai dati, dei com- 
ponenti proprietari molto potenti che per- 
mettono di connettersi ed utilizzare basi di 
dati presenti sul proprio sistema. Per utiliz- 
zarli è possibile anche immetterli nell'inter- 
faccia come un qualsiasi controllo, ed impo- 
starne i le proprietà nel pannello delle pro- 
prietà 



f0 I Stat^ logsj 

l .i » i L'i -I » _ in il 
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Q JBuilder disporre di un database inte- 
grato che tramite driver JDBC è possi- 
bile utilizzare per costruire le proprie appli- 
cazioni. Tramite JDataStore (questo è il suo 
nome), si possono creare nuovi database, 
impostarne le tabelle e riempirle di dati, 
nonché effettuare query e tutte le procedu- 
re di comune utilizzo. Per avviare JDataSto- 
re selezionare Tool /JDataStore Explorer. 



i JDataStore Server 



File Help 



JDataStore Server r; shi.ftciown 
Usere E =. i: II =.t=>!.=,;e: ''-W-'.r- 

|2508 
Ternp directory: 




H Per configurare i parametri di JDa- 
taStore è possibile richiamare il ser- 
ver del servizio. 

Per farlo è necessario selezionare Tool/ 
JDataStore Server. 

Da qui è possibile vedere lo stato dell' ap- 
plicazione, impostare la porta su cui ope- 
ra, visualizzare le connessioni e molto al- 
tro. 
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FUNZIONALITÀ 
AVANZATE 

Le possibilità di JBuilder 9 sono vera- 
mente entusiasmanti, ed una volta ap- 
preso come possono semplificarvi la vi- 
ta non credo che potrete privarvene fa- 
cilmente. La versione Personal è quella 
dedicata allo sviluppo di applicazioni 
single-tier, per questo è quella in cui so- 
no presenti in forma ridotta, ma nelle al- 
tre due versioni possibili (Developer & 
Enterprise) svolgono veramente la parte 
del leone. Pensate ad esempio alla pos- 
sibilità di scegliere quale versione del- 
TJDK utilizzare per far girare l'applica- 
zione che state sviluppando, alla capa- 
cità di suddividere il progetto in più 
parti per compilare o eseguire solo alcu- 
ne parti, alla opportunità (nella versione 
Enterprise) di visualizzare l'applicazio- 
ne sotto forma di diagrammi UML na- 
vigabili che semplifichino la visione 
d'insieme del progetto. Ma anche fun- 
zioni di refactoring avanzate, che vi per- 
mettono di aggiornare automaticamente 
dipendenze in caso di cambio di nomi, 
spostamenti, modifiche varie, rendendo 
di fatto un cambiamento al software 
un'operazione non preoccupante. Un'al- 
tra potente feature riguarda la funzione 
di debug, che permette di ispezionare in 
fase di runtime non soltanto i file locali 
dell'applicazione, ma anche, nella ver- 
sione Enterprise del prodotto, servlet, 
pagine jsp, applet ed Enterprise Java 
Bean. Per chi sviluppa applicazioni En- 
terprise poi, esiste anche la possibilità di 



testare le prestazioni dei componenti di- 
stribuiti, per individuare eventuali colli 
di bottiglia e ottimizzare il funziona- 
mento generale dell'applicazione (ver- 
sione Enterprise). Se siete interessati 
dalle possibilità di integrazione del pro- 
dotto con le fonti di dati (e mi piacereb- 
be conoscere chi non lo sia oggigiorno), 
sarete contenti di sapere che la Borland 
vi semplifica il lavoro permettendovi di 
disporre di componenti aggiuntivi spe- 
cifici per questo scopo, che rendono im- 
mediata la presentazione dei dati e la 
modifica di questi ultimi, sia sotto for- 
ma di componenti di interfaccia utente, 
che come funzioni di data-browsing in- 
tegrate nell'interfaccia principale. JBuil- 
der 9 prevede poi la possibilità di distri- 
buire il proprio lavoro, inserendo in un 
unico pacchetto i file che compongono 
la propria applicazione, consentendo di 
distribuire il software in diversi formati, 
che spaziano dal classico eseguibile, al- 
l'applet, passando per gli Executable Jar 
e diversi altri. Ovviamente, essendo Ja- 
va pensato per funzionare senza modifi- 
che su tutte le piattaforme, è possibile 
costruire, a partire dallo stesso codice e 
grazie al comodo wizard, applicativi per 
tutti i maggiori sistemi operativi: Win- 
dows, Linux, Solaris e Mac OS X. 
Write once, run everywhere!! 



PER CONCLUDERE 

In conclusione, come già anticipato, 
questo prodotto è veramente completo, 



ed anche se la versione personal risulta 
essere quella indirizzata allo sviluppo di 
applicazioni non distribuite, e quindi la 
meno complessa, è comunque adatta ad 
un utilizzo di tipo professionale. Se da 
poco vi siete cimentati con lo sviluppo 
di applicazioni Java, forse sarebbe pre- 
feribile un prodotto più semplice che vi 
permetta di spendere più tempo nella 
scrittura di codice piuttosto che con le 
funzioni della sua interfaccia. 
Se invece siete padroni del linguaggio, e 
siete alla ricerca dell' IDE definitivo, che 
permetta di compiere operazioni avan- 
zate e che garantisca automazioni che 
facilitino e velocizzino lo sviluppo, beh 
allora credo che siate arrivati nel posto 
giusto. Questo strumento si posiziona 
infatti ai massimi livelli qualitativi, e ri- 
sulta essere la scelta migliore per coloro 
che hanno esigenze elevate o progetti di 
media o grande complessità da svilup- 
pare. 

Giuliano Uboldi 



Requisiti di sistema 

• 256 MB di memoria RAM (512 Racco- 
mandati) 

• 500 MB di HardDisk liberi 

• CD-Rom Drive 

• Monitor ad alta risoluzione (1024 x 768 
- 256 colori minimo) 

• Dispositivo di puntamento (mouse o 
trackball) 

• Intel Pentium 11/233 MHz o superiore 
(o compatibile) 

• Microsoft Windows 2000 (SP2) , XP, NT 
4.0 (SP6a) 



Correzione degli errori 




Q JBuilder dispone di diversi modi per 
assicurarsi che la propria applicazione 
contenga meno errori possibili. Il primo è la 
correzione automatica, che segnala in tem- 
po reale la presenza di errori di sintassi o 
anche nomi di classi o variabili sconosciute. 
Non sarà necessario compilare il program- 
ma per conoscere eventuali errori di digita- 
zione. 



Qln caso di errori più seri occorre uti- 
lizzare il debugger. Per avviare il pro- 
cesso occorre selezionare, dopo aver impo- 
stato dei BreakPoint facendo click con il ta- 
sto destro sulla riga di codice che intendia- 
mo controllare, ed avere selezionato la voce 
adatta, Run/Debug Project. Si avranno a di- 
sposizione tutti gli strumenti per controlla- 
re passo passo l'esecuzione. 



HSe le cose si dovessero poi fare vera- 
mente difficili, è sempre possibile ri- 
correre all'help del prodotto, che integra 
oltre che alla documentazione ufficiale Ja- 
vaDoc e alla documentazione sul program- 
ma, anche esempi e tutorial che è possibi- 
le scaricare gratuitamente dal sito della 
Borland, a patto di disporre di una connes- 
sione ADSL. 



12^>* s 



t t 



http ://www. ioprogrammo.net 



► ► ► ► ► ► ► ► ► ► ► IL SOFTWARE SUL CD 



Macromedia 
Authorware 7 

La prima scelta per la erezione di contenuti e-Learning. 




Sempre all'avanguardia nel settore della 
programmazione di applicazioni multi- 
mediali, con questa nuova versione di 
Authorware, Macromedia ha ampliato no- 
tevolmente le potenzialità dell'ambiente 
attraverso numerosi miglioramenti. Tra i 
tanti, segnaliamo: la possibilità di importa- 
re presentazioni Power Point, il supporto 
per la scrittura e Y esecuzione di codice Ja- 
vaScript, la gestione di XML sia in input 
che in output, il pieno supporto per il for- 
mato DVD ed una nuova e più intuitiva in- 
terfaccia utente. Proprio grazie alla nuova 
interfaccia, Authorware può proporsi con 
eguale forza sia agli sviluppatori esperti sia 
a programmatori alle prime armi o utenti 
occasionali: a tutti è garantita la possibilità 
di sviluppare software di e-Larning al mas- 
simo livello. Authorware 7 consente di in- 
tegrare qualsiasi contributo (grafica, audio, 
animazioni, video e filmati Flash) air inter- 
no di un ambiente coerente con Y imposta- 
zione di tutta la famiglia Macromedia MX, 
con un ampio uso del drag&drop per sem- 
plificare la creazione delle applicazioni. 
Fondamentale risulta la possibilità di gene- 
rare applicazioni sulla base di presentazio- 
ni Power Point già esistenti. Il diffuso sup- 
porto di XML consente poi di creare appli- 
cazioni estensibili i cui comportamenti e 
contenuti possono essere facilmente modi- 
ficati anche in fase post-deployment. 




Fig. 1: Wizard per la creazione di 
applicazioni. 



LO SVILUPPO 
DELL'APPLICAZIONE 

Ogni volta che creiamo una nuova applica- 
zione, ci viene chiesto il tipo di contenuto 



che vogliamo produrre. Da questo punto in 
poi saremo guidati da un wizard alla crea- 
zione degli elementi fondamentali dell' ap- 
plicazione. U intero processo di sviluppo 
avviene attraverso una interessante com- 
mistione di programmazione visuale e co- 
dice, che consente di tenere sempre sotto 
controllo Finterà struttura dell'applicazio- 
ne. Questa caratteristica, unita alla assoluta 
uniformità allo standard Macormedia per 
le interfacce utente, riduce moltissimo il 
tempo di apprendimento. Tutto l'ambiente 
risulta ampiamente configurabile con pan- 
nelli e barre di comando aggregabili e ripo- 
sizionabili a piacere. 




Fig. 2: L'ambiente offre una interessante 
combinazione di componenti visuali. 



LE NUOVE 
CARATTERISTCHE 

Il nuovo supporto per i DVD consente di 
aumentare notevolmente la durata e la qua- 
lità delle presentazione e dei contenuti che 
si vogliono proporre. Inoltre, il supporto a 
JavaScipt (ottenuto grazie allo stesso moto- 
re presente in Dreamweaver MX) consente 
una fortissima dose di interattività, che si 
traduce in applicazioni più divertenti ed ef- 
ficaci. Infine, il supporto ai dati XML con- 
sente una più semplice connessione a con- 
tenuti Web, migliorando l'esperienza degli 
utenti e semplificando la gestione e l'ag- 
giornamento dei prodotti distribuiti. 

NON SOLO TRAINING 

Benché il campo d'azione preferito sia di- 
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I mport Frorm: C: \accessibility. xml 
Action: Idle 
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Fig. 3: Pieno supporto per l'XML. 

chiaratamente l'e-learning e le applicazioni 
di training, Authorware si presta ottima- 
mente alla creazione di qualsiasi applica- 
zione multimediale. Presentazioni, giochi e 
chioschi virtuali sono un piccolo esempio 
di quello che l'ambiente può realizzare. La 
completa apertura verso Power Point e 
verso tutti gli altri strumenti Macromedia, 
fa il paio con il forte supporto per XML, 
rendendo possibile armonizzare Author- 
ware in qualsiasi contesto lavorativo. Ma- 
cromedia Authorware 7 è disponibile sia 
come prodotto a se stante, sia come parte 
della Macromedia eLearning Suite, che in 
elude anche Flash MX e Dreamweaver MX. 



Installazioni 

In alcuni casi si sono manifestati dei pro- 
blemi nella fase di installazione dell'ap- 
plicativo. E' possibile che, dopo la proce- 
dura di installazione, al primo tentativo di 
avvio, si riceva un messaggio di errore. 
In questo caso è sufficiente lanciare il fi- 
le VSetupT.exe, locato nella directory di 
installazione di Authorware (tipicamente 
C:\Programmi\Macromedia\Authorware 
7.0). Fatto ciò non ci dovrebbero presen- 
tarsi altri problemi e l'applicazione sarà 
pronta ad essere avviata correttamente. 



Authorware 7 

• Produttore: Macromedia 

• Licenza: Trial 

• Prezzo: € 2929 * 

• Aggiornamento: € 389 * 

• Prezzo della eLearning Suite: € 3419 * 

• Sul web: www.macromedia.it 

• Sul CD: \soft\tools\Authorware\ 

*#" prezzi sono al netto dell'IVA 
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Flash IntroBuilder-SX Lite 3.0 



Per creare introduzioni Flash in un lampo! 



Un potente e semplice tool che con- 
sente di creare affascinanti intro- 
duzioni Flash ai nostri siti in pochi 
istanti e con uno sforzo pari a zero! Un 
semplicissimo Wizard ci guida nella 
scelta dello sfondo, dell'animazione e 
della musica che accoglierà i visitatori 
delle nostre pagine Web. Una presenta- 
zione in Flash del proprio sito è un po' 
la carta da visita del nostro lavoro: con- 
siderate superflue e noiose fa molti, le 
introduzioni possono comunque rap- 
presentare un'attrattiva ed un modo 



per esprimere efficacemente lo "spiri- 
to" del sito che abbiamo sviluppato. 



FACILE 

Il lavoro di chi si accinge a creare 
un'introduzione con IntroBuilder si ri- 
duce alla scelta delle varie componenti 
multimediali: le musiche (in Mp3) da 
utilizzare come sottofondo, le immagi- 
ni delle scene che comporranno il fil- 
mato, l'animazione di presentazione. Il 
rischio di omologazione che si corre 




IntroBuilder-SX Trial Version 



— ^P- 
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Fig. 2: Splash-screen dell'applicazione. 

adottando prodotti "precotti" come 
questo è mitigato dall'ampia scelta di 
scene e combinazioni possibili. Una 
volta effettuate tutte le scelte richieste, 
è sufficiente cliccare sul pulsante "Save 
Current Project" per salvare il file Flash 
di introduzione. Per utilizzarlo nel no- 
stro sito, è necessario poi effettuare l'u- 
pload del file ottenuto nella root del 
Web Server. Non è esclusa la possibilità 
di copiare il file su CD ed utilizzarlo in 
locale per presentazioni multimediali. 
La scintillante bellezza delle animazio- 
ni Flash è ora disponibile a chiunque, 
senza che sia richiesto alcun grado di 
esperienza. 



Fig. 1: Un esempio dei risultati ottenibili con Flash IntroBuilder-SX. 



IntroBuilder-SX Lite 3.0 

• Produttore: WebDesignHQ.com 

• Licenza: trial 

• Prezzo: $199 

• Sul Web: http://www.webdesignhq.com/ 

• Sul CD: \soft\tools\IntroBuilder\ 



Pochi passi per creare un'introduzione 
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Q Tutta la creazione dell'introdu- 
zione è completamente assistita 
da wizard. 

Si comincia con la scelta della direc- 
tory e del nome del progetto. 
L'impatto visivo contribuisce a rende- 
re più piacevole lo sviluppo. 
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BE' possibile scegliere fra decine 
di stili, ognuno caratterizzato da 
animazioni molto curate. L'effetto ge- 
nerale ha un aspetto decisamente 
"cool", e la vastità dei temi proposti 
consente di integrarsi con coerenza in 
qualsiasi sito. 




HI numerosi effetti sonori e gli 
sfondi che è possibile utilizzare, 
sono stati scelti con estrema cura. La 
resa finale è un introduzione di altissi- 
mo livello, soprattutto se si considera 
il tempo davvero ridotto che ci è ri- 
chiesto. 
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IntelliJ Idea 3.0.4 



Sviluppare in Java... con piacere! 

Idea è un ambiente di sviluppo che consente di creare applicazio- 
ni Java air interno di un IDE ben fatto e gradevole. In questa nuo- 
va versione, aggiunge nuove importanti caratteristiche: pieno sup- 
porto per JSP/EJB, integrazione con Ant e JUnit, supporto per XML 
e una cospicua collezione di API per la realizzazione di plug-in. 
Inutile sottolineare che sono presenti tutte le più importanti carat- 
teristiche comuni in un moderno IDE: un ottimo debugger, avanza- 
te funzioni di search&replace, colorazione sintattica. Una menzione 




particolare la merita il completamento automatico del codice che si 
fa apprezzare con l'uso per la sua semplicità e per la flessibilità con 
cui segue le abitudini dello sviluppatore. E possibile personalizzare 
qualsiasi aspetto dell' applicazione: dalla formattazione del codice, 
alla colorazione sintattica, all'organizzazione dell'import, fino ad 
arrivare ai colori utilizzati per evidenziare gli errori e all'orienta- 
mento delle finestre e delle toolbar. Un'assenza di peso risulta esse- 
re quella di un apposito strumento per la realizzazione dell'inter- 
faccia utente. A differenza di molti altri IDE, Idea ha coraggiosa- 
mente rinunciato a questa caratteristica che, sebbene comoda in 
molte situazioni, risulta spesso un inutile appesantimento per i pro- 
grammatori che non ne fanno uso. 



Nota 

Per richiedere la chiave di attivazione è necessario compilare 
un form all'indirizzo: http://www.intellij.com/download/idea/try 
/Windows. L'indirizzo è diverso da quello proposto all'atto 
dell'installazione di IDEA. 



IntelliJ Idea 3.0.4 

• Produttore: JetBrains, Inc. 

• Sul Web: www.intellij.com/jetbrains/ 

• Prezzo: $499 

• Sul CD: \soft\tools\IDEA\ 



Revolution 2.0.1 



Per creare applicazioni multipiattaforma 

Per gli sviluppatori che vogliono creare applicazioni che possano 
girare su qualsiasi sistema operativo da Mac OS a Windows, pas- 
sando per il sempre più popolare Linux: ecco pronto Transcript, un 
linguaggio di alto livello, integrato in Revolution, e che consente di 
sviluppare applicazioni efficienti in un tempo brevissimo rispetto a 
linguaggi più classici come Java, C++ o VB. Due caratteristiche su 
tutte: multipiattaforma, e brevità. Funzioni che prima richiedevano 



,,,„ 






ni file: pi 



,,,,, 



sck[1]/cartl/g™ipP]*uttoii[1] 







complesse subroutine, si risolveranno con una singola riga di codice. 
La versione che trovate nel ed limita ad un massimo di 10 righe il co- 
dice associabile ad ogni oggetto. A parte questa limitazione, trovere- 
te tutte le funzioni disponibili nella versione a pagamento e potrete 
anche distribuire le applicazioni sviluppate con questo pacchetto. In 
questa versione è stato integrato il supporto per SOAP ed una libre- 
ria specifica per il parsing XML. Tra le cose che più si apprezzano è 
che l'applicazione non necessita di installazione e non va ad incidere 
sul registro di sistema: è sufficiente compattare il file compresso e 
lanciare l'exe di riferimento. Al primo avvio ci verrà chiesto se vo- 
gliamo l'esecuzione in modalità gratuita o in modalità evaluation. La 
modalità gratuita non ha limiti di tempo e supporta unicamente la 
connessione via ODBC ai database. La versione evaluation, oltre ad 
ODBC, supporta nativamente Oracle, MySQL e PostgreSQL, ma sca- 
de dopo trenta giorni. Per una più completa informazione sulla li- 
cenze disponibili si rimanda al web: http://www.runrev.com/Revolu- 
tionl/licensingl .html. 
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Revolution 2.0.1 

• Produttore: Runtime Revolution Ltd. 

• Sul Web: www.runrev.com 

• Prezzo: free 

• Sul CD: \soft\tools\revolution.zip 
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JBoss 4.0.0DR1 

Il più potente application 
server open source 

JBoss è un application server Open 
Source scritto interamente in Java. 
Grazie a JBoss è possibile far girare 
componenti EJB (Enterprise Java 
Beans) e qualsiasi applicazione svi- 
luppata attraverso la tecnologia J2EE 
di Sun. 

Grazie ai connettori JMX, JBoss con- 
sente una notevole flessibilità e si pre- 
sta agli utilizzi più disparati. In parti- 
colare è possibile sviluppare un pro- 
prio transaction-manager ed un pro- 
prio persistence-manager. 
Nella versione che trovate nel CD è in- 
cluso Tomcat 4.1.24 al posto di Jetty 
Sul CD: \soft\tools\Jboss\ 



RoboHelp Office X4 

Creare Help di livello 
professionale 

Un tool di altissimo livello professio- 
nale per la creazione di help sia per 
applicazioni desktop che Web Based. 
RoboHelp è in grado di creare sistemi 
di help utilizzabili attraverso un qual- 
siasi browser e su qualunque piat- 
taforma. Le facilitazioni per lo svilup- 
patore sono molte e vanno dalla crea- 
zione in automatico di indici e glossa- 
ri, alla generazione di oggetti grafici. 
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I contenuti possono essere importati a 
partire da numerosi formati, inclusi 
HTML e Word. 

Versione di valutazione valida quindi- 
ci giorni. 
Sul CD: \soft\tools\robohelp.exe 



FsDBPrint 1.0 

Per stampare la struttura 
delle tabelle di Access 

Alzi la mano chi non ha mai fatto uno 
screenshot della struttura delle tabelle 
di un database in Access, al fine di do- 



cumentare o solo tenere traccia delle 
relazioni impostate. 
Questa piccola ma utilissima applica- 
zione ci solleva proprio da questo 
umiliante(!) compito: i documenti 
stampati risultano al contempo facili 
da leggere e compatti. E 7 possibile 
stampare anche il dettaglio dei campi 
che compongono le varie tabelle. 
Sul CD: \soft\tools\fsDBPrint.exe 



Installer2Go 
Freeware 3.1.1 

Un sistema facile e gratuito 
per realizzare pacchetti 
di installazione 

Un tool per la creazione di file autoin- 
stallanti che non impegna lo sviluppa- 
tore nel dover imparare l'ennesimo 
linguaggio di scripting: con una inter- 
faccia che punta tutto sul drag&drop, 
realizzare pacchetti di installazione 
diventa un vero gioco da ragazzi. 



■ -|q|x| 



Divini nI QU 



U« 






_ i • . - ■ 

É--€a Application 

I--C] BrushLibraries 
+ _| Help 
+ _| Helpers 
I--Q KeyboardShortcì 
! É-Q OtherLibraries 
I _| Plug-ins 
+ _| Required 
+ _| S ampie Files 
+ _| Settings 
!■ Q StjileLibiaries 
UQSwatchUbraries 

_| System 
* _J Utilities 
■■■CD Action Sets 
; Q Common Files 
E Q Windows 



HI 




Mwifed 



- Il 1 


li' . UHM 1 




05.26.00 1(K 


-Il 


05.26.00 04:[ 


ADplii;ai.»n E :<>.e 


05.2G.00 04:t 


RSLFile 


05.26.00 04:1 


HTMLDocumen 


05.26.0010:; 



instatelo 2.0 Frei ire-Vers 



Benché gratuito, Installer2Go va in- 
contro a tutte linee guida per la certifi- 
cazione WindowsXP. 
Sul CD: \soft\tools\i2gl.exe 



Norpath Elements 
Studio 2.0 

Creare applicazioni 
multimediali e interattive senza 
scrivere codice 

Norpath Elements Studio è un innova- 
tivo ambiente per la creazione di ap- 
plicazioni multimediali che rinuncia 
completamente al codice a favore di 
una programmazione completamente 
visuale. 

Un completo supporto per elementi 
multimediali, animazioni e database, 
ne fa un ottimo strumento per la rea- 
lizzazione di applicazioni per l'e-lear 




E' possibile distribuire le applicazioni 
su una pluralità di media: dai CD- 
ROM, ai chioschi multimediali alle in- 
tranet. 

Versione di prova valida venti giorni. 
Sul CD: \soft\tools\nestudio-win.exe 



EmEditor 3.34 

Un editor pronto a qualsiasi 
linguaggio 

Un versatile editor testuale che, grazie 
al supporto per i plug-in, può crescere 
insieme alle nostre esigenze. Molti svi- 
luppatori l'hanno già scelto grazie so- 
prattutto all'ampio supporto fornito 
per tutti i più diffusi linguaggi di pro- 
grammazione: 

ASP, C++, C#, CSS, HTML, Java, 
JavaScript, JSP, Pascal (Delphi), Perl, 
PHP, Python, Ruby, SQL, Tex (LaTeX), 
VBScript, e Windows Script. 

Ognuno di questi linguaggi gode di 
un proprio syntax highlighting che 
semplifica la lettura di codice scritto 
da terze parte e riduce la possibilità di 
commettere errori durante la digita- 
zione di nuovo codice. 
Versione di prova valida trenta giorni. 
Sul CD: \soft\tools\eme334e.exe 



SQLSchema 2.2.2 

Compara la struttura 

di due database SQL Server 

Un tool per amministratori di basi di 
dati che consente di confrontare lo 
schema di due database SQL Server. 
Oltre a confronto, SQLSchema consen- 
te di allineare le differenze esistenti 
fra i due database. 

Tutti i cambiamenti effettuati sono sal- 
vati in un file di Log. 
Versione dimostrativa. 
Sul CD: \soft\tools\ 
sqlschema. 2. 2. 2.setup.exe 
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Liberty BASIC for 
Windows 3.03 

Un linguaggio per cominciare 
bene 

Un linguaggio di programmazione 
sviluppato appositamente per chi si 
avvicina la mondo della programma- 
zione. 

Grazie alla funzione FreeForm si pos- 
sono sviluppare complesse interfacce 
Windows con la semplicità offerta da 
un ambiente visuale. 
L'ide comprende un editor con fun- 
zioni di highlighting sintattico e un 
completo debugger. 
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Versione di prova limitata a trenta 

giorni. 

Sul CD: \soft\tools\lb303win.exe 



3D Developer Studio 
for Visual Basic 6.0 

Crea il tuo videogioco 
in Visual Basic 

Un ambiente per realizzare applica- 
zioni in 3D utilizzando Visual Basic 
6.0. Utilizzato da molti sviluppatori 
per l'alto livello qualitativo raggiun- 
gibile con un ridotto sforzo ed in bre- 
vissimo tempo. Indirizzato principal- 
mente alla creazione di videogiochi, 
può essere proficuamente utilizzato 
per realizzare applicativi tridimensio- 
nali di qualsiasi genere. La licenza è 
gratuita, per l'installazione è necessa- 
ria una chiave di attivazione che si 
può richiedere collegandosi all'URL: 
http://www.3dstate.com/Pages/PagesI/ 
Registration/ downloadlist.htm 
Sul CD: \soft\tools\ 
3D_Developer_Studio_VB602.exe 



checkstyle 3.1 

Il nostro codice sempre 
al meglio 

Checkstyle è principalmente un tool a 



linea di comando che esegue un con- 
trollo di conformità su un file Java (o 
un gruppo di file fino ad un intero 
progetto grazie anche alla completa 
integrazione con ANT). Le regole da 
verificare ed il grado di severity di 
una eventuale non conformità sono 
configurabili e memorizzabili in file 
XML per i quali è presente un'apposi- 
ta grammatica. 

Insieme al pacchetto sono disponibili 
già, come esempio, due file di confi- 
gurazione pronti per l'uso: uno conte- 
nente un pacchetto di regole persona- 
lizzato di Checkstyle ed un altro con- 
tenente una completa rimappatura 
per Checkstyle delle Code Conven- 
tions. 
Sul CD: \soft\tools\checkstyle-3.1.zip 



Sirid 1.14 

Per gestire i tuoi progetti 
software 

Un sistema professionale per la ge- 
stione di progetti software: con Sirid è 
possibile gestire il ciclo di vita di 
un'applicazione dal punto di vista 
dello sviluppatore. 

E' possibile assegnare compiti e prio- 
rità ai componenti del team ed i bug 
riportati, oltre ad essere memorizzati 
in un database, possono essere auto- 
maticamente inoltrati al responsabile 
del progetto. 




Grafici statistici e timesheet aiutano 
ad ottimizzare il lavoro degli svilup- 
patori. 

Sirid è accessibile attraverso un comu- 
ne browser, non è dunque necessario 
alcuna installazione lato client e risul- 
ta garantita la delocalizzazione della 
forza lavoro. 
Sul CD: \soft\tools\sirid.exe 



602Pro LAN Suite 2003 

Un mail server gratuito e sicuro 

Un mail server gratuito, che integra 
funzioni anti-virus, anti-spam e fi- 



rewall. La sicurezza delle comunica- 
zioni è garantita dall'uso del protocol- 
lo SSL SMTP/POP3, mentre per Tanti- 
spam è possibile definire una lista ne- 
ra ed è garantito l'aggiornamento tra- 
mite DNS. 
Sul CD: \soft\tools\ls2003.exe 



HTML Ease Pro 2.0 

I tuoi documenti sul Web... 
con un clic! 

Un avanzato ambiente per la prepara- 
zione di pagine Web. HTML Ease è in 
grado di convertire in pagine html 
qualsiasi documento prodotto dai più 
diffusi programmi di Word Processing 
e fogli elettronici. 

E' incluso un completo editor ricco di 
funzionalità per semplificare la scrit- 
tura di codice HTML. 
Versione di prova limitata a dieci gior- 
ni. 
Sul CD: \soft\tools\hep20b.exe 

Apache Axis 

Un SOAP engine in Java 

Axis è un SOAP Engine e consiste in 
un'implementazione Java della speci- 
fica SOAP. 

Si tratta della terza generazione di 
Apache SOAP ed è curata e rilasciata 
in modalità open source dalla Apache 
Software Foundation all'interno del- 
l'ambizioso Apache XML Project. 
In questa versione Axis è stato profon- 
damente ristrutturato e mentre prima 
si trattava di un semplice strato soft- 
ware in grado di renderci trasparente 
l'utilizzo di SOAP nello sviluppo di 
applicazioni scritte con tecnologia Ja- 
va, adesso è un vero e proprio fra- 
mework che ci permette di costruire, 
con estrema semplicità, tutto quello 
che ci può servire per rendere fruibili 
i nostri servizi sotto forma di Web Ser- 
vices: server, client, proxy, stub, skele- 
ton e gateway da e verso il protocollo 
SOAP. 

Ci troviamo di fronte quindi ad un 
ambiente completo che garantisce 
l'interoperabilità con servizi che uti- 
lizzano tecnologie differenti grazie al 
supporto completo e nativo per 
WSDL1.1. 

Nella directory trovate anche i sor- 
genti. 
Sul CD: \soft\tools\Axis\ 
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Mediator 7 exp 

Creare le tue presentazioni per 
qualsiasi media 

L'intuitiva interfaccia di Mediator 
(completamente drag&drop) unita- 
mente alla flessibilità data dal suppor- 
to per la programmazione in VB e Ja- 
vaScript, consente di creare ricchissi- 
me applicazioni multimediali in poco 
tempo. Particolarmente indicato per 
la realizzazione di presentazioni di li- 
vello professionale o per applicazioni 
di training che prevedono una forte 
interattività con gli utenti. 




Versione dimostrativa, non sono pre- 
visti limiti di tempo per il suo utilizzo, 
ma le applicazioni create hanno un li- 
miti di sette giorni. 
Sul CD: \soft\tools\ 
m7uk_exp_demo.exe 



DzSoft Perl Editor 5.4 

Per la scrittura e il debug di 
script in Perl 

Un editor che presenta tutte le princi- 
pali funzioni per scrivere ed effettuare 
il debug di script PERL. Oltre al con- 
sueto Syntax highlighting, ci ha ben 
impressionato la possibilità di testare 
il codice senza la necessità di lanciare 
un Web Server. 

È possibile uploadare il codice via 
FTP direttamente dall'ambiente. 
Sul CD: \soft\tools\dzperl54.zip 



Advanced Hex Editor 
3.2 

Sviluppo e recupero dati a 
basso livello 

Un editor che permette di analizzare e 
modificare a basso livello dati conte- 
nuti sia su disco sia in memoria. 
Utilissimo per il reverse engineering e 



soprattutto per le situazioni di recu- 
pero dati. Ricco di funzionalità per la 
gestione di grosse porzioni di dati, 
prima fra tutte una funzione di ricerca 
ottimizzata. 

Versione di prova valida trenta giorni, 
rop; CRC generation; diffing; and mo- 
re. 
Sul CD: \soft\tools\installAXE.exe 

RenderX XEP 3.5 

Per convertire documenti XML 
in PDF 

Un'applicazione commerciale in gra- 
do di effettuare la conversione da do- 
cumenti XML in PDF o in formato Po- 
stScript. Accetta in input dati in for- 
mato XML e fogli di stile XSL, il ren- 
dering è effettuato proprio come com- 
binazione dei due ingressi. 
Versione dimostrativa, un watermark 
è applicato su ogni documento pro- 
dotto. XEP offra un valido supporto a 
XSL FO, grafici SVG e funzioni di link 
PDF-to-PDF 
Sul CD: \soft\tools\xep35_trial.zip 



RatScan 1.2 

Testa la robustezza del tuo 
codice 

Attraverso una efficace interfaccia 
grafica, RatScan consente di esamina- 
re il nostro codice alla ricerca di difet- 
ti e vulnerabilità E' possibile eseguire 
lo scan su codice scritto in PHP, C/ 
C++, Perl, e Python. 




Versione di prova limitata a trentuno 

giorni. 

Sul CD: \soft\tools\RatScan_l. 2.exe 

TestTrack Pro 5.1 

Tracciare bug e richieste degli 
utenti 

TestTrack è un tool cross-platform per 



la catalogazione di bug e la pianifica- 
zione dello sviluppo software. Può es- 
sere interrogato via browser e si inte- 
gra perfettamente con Visual Studio 6, 
Visual Studio .NET e Visual SourceSa- 
fe. Permette agli utenti Windows ma 
anche Macintosh di accedere simulta- 
neamente allo stesso database cross- 
platform. 

Inoltre, include ottime funzioni per il 
filtering permettendo di creare delle 
liste di problemi organizzate per prio- 
rità. Ottima la possibilità di generare 
dei report. 

Licenza di valutazione della durata di 
trenta giorni, è possibile tracciare un 
massimo di 15 bug. 
Sul CD: \soft\tools\ttprowininstall.exe 



OraEdit 3.3 

Un editor su misura per Oracle. 

La versione aggiornata dell'ottimo 
editor gratuito progettato su misura 
per gli sviluppatori Oracle. Il tool per- 
mette di editare e compilare il codice 
PL/SQL direttamente dal database, 
consente di creare nuovi oggetti a par- 
tire da templare, presenta funzioni di 
import/export del codice ed altre uti- 
li caratteristiche. 

OraEdit presenta il supporto per i 
workspace e consente di lavorare su 
più database allo stesso tempo. 
La versione 3.3 include il pieno sup- 
porto per Oracle 9i, nuovi menu in sti- 
le XP, una interfaccia di più veloce uti- 
lizzo e numerosi altri ritocchi. 
Sul CD: \soft\tools\oraedit.exe 



Surround SCM 1.5 

Tiene traccia dei cambiamenti 
durante lo sviluppo delle 
applicazioni 

La gestione dei cambiamenti apporta- 
ti durante lo sviluppo delle applica- 
zioni è una componente essenziale 
per lo sviluppo di qualsiasi applica- 
zione. 

Grazie alla sua integrazione con Vi- 
sual Studio, Surround SCM consente 
di velocizzare le operazioni di gestio- 
ne, migliorando la qualità del codice 
che scriviamo. 

Versione di valutazione valida trenta 
giorni. 
Sul CD: \soft\tools\sscmwininstall.exe 
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"'L'arte di nascondere le informazioni. 

Algoritmi 

Steganografici 



La steganografia, insieme alla 

crittografia, è uno dei 

fondamentali strumenti per la 

trasmissione di messaggi 

segreti ed è quindi usata in 

modo massiccio nell'ambito 

della sicurezza informatica. 



Abbiamo già trattato l'argomento stega- 
nografia nello scorso appuntamento, 
evidenziando le fondamenta teoriche 
ed approfondendo alcuni importanti risvolti di 
carattere tecnico. Tra quelle pagine avevo an- 
che lanciato una sfida, al momento in cui vi 
scrivo, tale sfida non è stata raccolta da nessu- 
no, o almeno nessuno è riuscito a risolvere il 
problema proposto. A tale proposito ricordo 
che avevo inserito nel testo dell'articolo del 
mese scorso un "semplice" messaggio stegano- 
grafato. Chi ha perso il precedente numero di 
ioProgammo si starà chiedendo di cosa stiamo 
parlando. Brevemente tenterò di introdurre 
nuovamente il problema, dando questa volta 
nuovi spunti, ma soprattutto, presentando de- 
gli algoritmi risolutori attualmente utilizzati. 
La steganografia è un metodo per nascondere 
(a rigore seguendo l'etimologia della parola 
greca si dovrebbe parlare di occultare) un 
qualcosa all'interno di un altro qualcosa. Ma 
cosa sono questi due qualcosa. Nell'accezione 
più generale possono essere elementi molto 
astratti e generici. Abbiamo visto come in un 
apparentemente innocuo discorso pronunciato 
da chiunque, si dice ad esempio che alcuni ter- 
roristi ne facessero uso compreso Bin Laden, 
possa esserci innestata una frase segreta. Cer- 
to, nell'ambito che ci riguarda gli elementi in 
gioco sono informazioni in formato digitale e 
quindi: testi, immagini, suoni e tutto ciò che 
possa essere memorizzato come un generico fi- 
le. Così, una foto di amici che a prima vista 
non insospettirebbe affatto, potrebbe celare 
importanti messaggi o altri immagini segrete. 




10 10110 
10011010 
10 110 11 
100 11000 



Fig. 1: Campionamento a fc di lKHz e 
quantizzazione a 8 bit, di una parte di segnale. 



O ancora un file sonoro che riproduce una can- 
zone in voga può nascondere testi o altre infor- 
mazioni segrete. Gli elementi in gioco, qualun- 
que essi siano, per comodità saranno indicati 
in seguito come messaggi. La potenza del me- 
todo è di trattare elementi digitali apparente- 
mente innocui, non soggetti quindi a controlli. 
Nella crittografia, invece, si sa benissimo a 
priori che si ha un messaggio cifrato, la diffi- 
coltà nel caso specifico è decifrarlo. L'unione 
dei due metodi assicura elevatissimi gradi di 
sicurezza nella trattazione di messaggi segreti. 
Ma entriamo nei particolari esaminando alcuni 
metodi e algoritmi. 

METODO LSB, DI COSA 
SI TRATTA 

Il metodo studiato nella puntata precedente è 
LSB. Lo riesaminiamo brevemente poiché 
esprime al meglio la filosofia sottesa alle tecni- 
che steganografiche. Chi ha letto l'articolo del 
numero scorso può saltare il presente breve 
paragrafo. Si parte dal presupposto che un'im- 
magine, come un file sonoro, rimane pressoché 



File sul CD 

\soft\codice\soluzioni 



File 
sul Web 



www.ioprogrammo.net 
/files/72/soluzioni 
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Campionamento 
e quantizzazione 

\~rK\ Il campionamento 
\^J\ e la quantizzazione 
sono i due passi da at- 
tuare per discretizzare 
un segnale analogico. 
Permettono cioè di tra- 
sformare una qualsiasi 
curva, che ad esempio 
descrive un segnale so- 
noro originale, in una se- 
quenza di bit. Tale tra- 
sformazione è indispen- 
sabile per la trasmissio- 
ne e il trattamento di se- 
gnali, poiché come Tabe 
del programmatore ri- 
corda l'elaboratore lavo- 
ra solo sequenze di bit. 
La frequenza di campio- 
namento (fc) indica per 
quali intervalli di tempo 
(T) bisogna misurare il 
segnale, si ricorda la re- 
lazione fc=l/T, mentre i 
range di quantizzazione, 
che saranno maggiori a 
fronte di un numero più 
elevato di bit, approssi- 
mano il valore della cur- 
va ad un numero che 
successivamente sarà 
trasformato in una se- 
quenza di bit (ad esem- 
pio, 8 o 16 bit). In figura 
è mostrato il processo di 
campionamento e quan- 
tizzazione (discreti zza - 
zione) di un segnale 
analogico. 



inalterata, o comunque subisce variazioni im- 
percettibili, qualora si "manomettano" i bit 
meno significativi delle informazioni di base. 
Ad esempio, un file bmp (bit map) rappresen- 
tato da una mappa di pixel di colore diverso è 
costituito da sequenze di terne di byte. Secon- 
do il metodo RGB (red, green, blue) ogni pixel 
assume il proprio colore come l'unione di tre 
primari, appunto rosso, verde e blu, la cui in- 
tensità di ognuno può variare in una scala tra 
256 valori, ossia tutte le possibili configurazio- 
ni che può assumere un byte. Secondo tale mo- 
dello ad un pixel sono associati tre byte, altri 
modelli prevedono un numero maggiore di 
byte. Cambiando l'ultimo bit di alcuni dei by- 
te che formano la tinta, viene alterato il colore 
del pixel in modo impercettibile. Si pensi che 
di per se il pixel è piccolo, è l'unità minima 
grafica, un semplice punto, inoltre, si altera il 
contributo di un colore facendolo passare in un 
livello di intensità contiguo al precedente in 
una scala di 256. La sequenza dei bit così mo- 
dificati da vita ad un'altra immagine, quella 
segreta, che in tal modo viene iniettata nella 
immagine principale denominata di copertura. 
Analoga conseguenza si raggiunge se il file ini- 
ziale di copertura è un sonoro o un filmato. Ta- 
le metodo fa comprendere come funziona la 
steganografia, ad ogni modo non è molto effi- 
ciente. 

Ad esempio, si rischia di perdere il messaggio 
segreto se l'immagine di copertura viene mo- 
dificata (ridimensionata o compressa), inoltre, 
è difficilmente applicabile ad alcuni formati 
compressi come il jpeg. Esistono altri metodi 
che non sono di tipo sostitutivo che garanti- 
scono migliori prestazioni. 

POSSIBILI ATTACCHI 

Prima di esaminare gli algoritmi vorrei fornire 
un nuovo contributo teorico. È importante ca- 
pire come sia possibile "attaccare" la stegano- 
grafia. È un errore pensare che il messaggio 
segreto o possa essere intercettato e decifrato 
oppure possa andare a buon fine e non essere 
scoperto. Vi possono essere anche delle situa- 
zioni intermedie che comunque garantiscono 
dei risultati parziali sufficienti alla sicurezza 
della trasmissione del messaggio segreto. Ap- 
prontando una classificazione dei possibili at- 
tacchi alla steganografia si distinguono cinque 
livelli: 

1. Solo steganografico; 

2. messaggio di copertura noto; 

3. messaggio segreto noto a posteriori; 



4. algoritmo steganografico conosciuto; 

5. messaggio scelto. 

Gli attacchi sono condotti da persone che in- 
tendono violare e decifrare la trasmissione se- 
greta. Nel caso della steganografia tale figura è 
conosciuta come steganalista e la corrispon- 
dente materia di studio è la steganalisi. Nella 
peggiore delle ipotesi lo steganalista non verrà 
a conoscenza della presenza di una trasmissio- 
ne segreta, il caso diametralmente opposto, 
che è il più favorevole possibile vede lo stega- 
nalista conoscere il messaggio segreto oltre che 
l'algoritmo usato. Ma esaminiamo i vari livel- 
li. Il primo si ha quando si intuisce che all'in- 
terno di un messaggio è nascosto qualcosa di 
segreto, in tal caso si conosce solo il messaggio 
steganografato. Situazione più favorevole si ha 
qualora si conosca oltre al messaggio stegano- 
grafato anche quello di copertura, così il con- 
fronto tra le due entità consentirà un'analisi te- 
sa alla individuazione dell'algoritmo usato e 
del messaggio nascosto, compito molto diffici- 
le sulla base di queste informazioni. Se a po- 
steriori si viene a conoscenza del messaggio 
segreto è possibile approntare uno studio più 
organico per l'individuazione dell'algoritmo e 
per la conseguente decifratura di altri messag- 
gi sullo stesso canale trasmissivo. Va detto che 
anche questo compito è arduo anche se più fa- 
vorevole rispetto al secondo tipo di attacco. Se 
si conosce l'algoritmo usato ci troviamo nel 
quarto caso che è sicuramente uno dei più for- 
tunati, infatti, successivi elementi steganogra- 
fati con lo stesso metodo potrebbero essere de- 
cifrati. Si tenga presente, ad ogni modo, che ta- 
le attacco non garantisce l'immediata indivi- 
duazione del testo nascosto giacché, in molti 
algoritmi si fa riferimento a delle password 
che potrebbero essere spesso cambiate. Quin- 
di, anche la conoscenza dell'algoritmo potreb- 
be non essere sufficiente al compito dello ste- 
ganalista. L'ultimo caso si ha quando si è a co- 
noscenza oltre che del messaggio segreto an- 
che dell'algoritmo e quindi l'unione dei due 
casi precedenti; si tratta della situazione più 
rosea che comunque non garantisce la decifra- 
tura di ulteriori messaggi sullo stesso canale. 

UN PRIMO APPROCCIO 
CON L'ALGORITMO 
DI A.BROWN:S-TOOLS 

Un algoritmo molto usato nel campo della ste- 
ganografia è stato sviluppato da Andrew 
Brown. Tale software reperibile in rete in ver- 
sione shareware prende il nome di S-Tools. Si 
tratta di un algoritmo sostitutivo, appartenen- 
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te alla famiglia LSB. S-Tools è in grado di na- 
scondere più messaggi nello stesso oggetto che 
può essere una immagine in formato jpeg, gif o 
bmp oppure un file sonoro wav. I passi dell'al- 
goritmo sono i seguenti: 

1. Compressione dei file da nascondere; 

2. cifratura mediante il programma MD5 con 
password scelta dall'utente; 

3. generazione casuale di una serie di numeri 
che individuano i byte dove inserire il mes- 
saggio nascosto. 

I primi due stadi sono dei preliminari e con- 
sentono di pretrattare i dati da nascondere se- 
condo metodi distinti dalla steganografia; essi 
vengono, infatti, compressi, in modo che occu- 
pino meno spazio e criptati, per avere un ulte- 
riore grado di sicurezza. Il primo punto con- 
sente, tra l'altro, di avere un testo di copertura 
di più esigue dimensioni. Il terzo passo è il più 
importante nell'ambito che stiamo esaminan- 
do. Tale sezione si occupa di iniettare il mes- 
saggio nascosto nei bit meno significati di al- 
cuni byte scelti casualmente. Da sottolineare 
che la sequenza random è generata in funzione 
di una password ed è quindi sempre differen- 
te. Per cifrare il testo non sarà sufficiente cono- 
scere l'algoritmo ma bisognerà possedere la 
password. Un esempio chiarirà il funziona- 
mento del programma sviluppato da A. 
Brown. Consideriamo come file di copertura 
un wav. È noto che un file di questo tipo si ot- 
tiene dalla discretizzazione del segnale analo- 
gico iniziale, attraverso la simultanea applica- 
zione dei due procedimenti di campionamento 
e quantizzazione. 

In Windows la quantizzazione è attuata con 8 
o 16 bit, cosicché si può attingere rispettiva- 
mente a scale di 256 e 655536 valori. Cambiare 
il bit meno significativo di alcuni byte che ope- 
rano la digitalizzazione (quantizzazione), soprat 
tutto nel secondo caso, produce modificazioni 
impercettibili anche alla più sensibile delle 
orecchie. Come si può comprendere si tratta di 
un procedimento del tutto analogo a quello 
adottato per le immagini. La particolarità del- 
l'algoritmo è che i byte che verranno modifica- 
ti nel loro ultimo bit sono scelti casualmente e 
dipendono dalla password. Tale relazione by- 
te-password è l'unico elemento che rimane ri- 
servato per evidenti motivi di sicurezza. 

UN SECONDO 
ALGORITMO: TEXTO 

Un interessante algoritmo prodotto da Kevin 



Maher attua la steganografia su testi. Un mes- 
saggio segreto viene nascosto all'interno di 
una frase opportunamente generata. Essendo 
l'autore inglese la frase generata sarà in tale 
lingua; focalizziamo ad ogni modo l'interesse 
sul metodo. Va detto subito che le frasi prodot- 
te, pur avendo un significato grammaticale, as- 
sumono un discutibile valore semantico, appa- 
rendo, il più delle volte, come periodi demen- 
ziali. Si ottiene un risultato simile ad un gioco 
in voga qualche anno fa nei paesi anglosasso- 
ni, di nome "mad libs" (improvvisazioni de- 
menziali) che consisteva nel riempire frasi con 
spazi vuoti apponendo sostantivi o verbi e ge- 
nerando quindi periodi dal significato spesso 
comico. Maher ha approntato un dizionario di 
parole divise in categorie che sono: oggetti, luo- 
ghi, verbi, avverbi e aggettivi. Inoltre, ha genera- 
to delle frasi modello (template) che contengo- 
no spazi vuoti da riempire con le parole prima 
classificate. Poiché ogni categoria è costituita 
da 64 alternative si possono codificare sei bit; 
essendo gli spazi vuoti cinque, il testo segreto 
per ogni frase può essere costituito al più da 30 
bit. Ogni parola contenuta nel dizionario occu- 
perà una posizione che è associata ad una con- 
figurazione di sei bit. Sulla base di questo cri- 
terio si attuano le due fasi di codifica e decodi- 
fica. Il tutto funziona se il trasmittente e il rice- 
vente usano lo stesso dizionario. Inoltre, è faci- 
le intuire come l'esigua quantità di parole sia 
una nota negativa che aiuta il compito dello 
steganalista. Ad ogni modo, ampliando il di- 
zionario, ed il numero di template, si può per- 
venire ad un metodo dalle prestazioni conside- 
revoli. Migliori performance si ottengono an- 
che in questo caso associando tecniche critto- 
grafiche. 

ALCUNI CENNI 
PRELIMINARI SU ALTRI 
ALGORITMI 

Per completezza di trattazione vanno citati al- 
tri metodi steganografici. Tra quelli esaminati 
dalle ricerche su internet mi sono soffermato 
su due che, oltre ad essere particolarmente in- 
teressanti, hanno il "pregio" di essere stati 
ideati da italiani. Di questi farò una breve de- 
scrizione. La libreria Psteg è stata prodotta da 
Roberto Fabbri, essa implementa una tecnica 
con permutazioni pseudocasuali. La chiave 
usata può essere o inserita a run time o essere 
attinta da keyring di chiavi pubbliche di PGP 
Sono previste operazioni preliminari come la 
compressione e la crittografia, inoltre, utiliz- 
zando la libreria, è facile produrre programmi 
a partire da algoritmi noti. 
Interessante è anche l'idea di Andrea Mazzoleni 



Alcune 
varianti 
di S-Tools 

\/%\ S-Tools è un pac- 
I ^\ chetto shareware 
che contiene più pro- 
grammi. I più importanti 
tra questi programmi so- 
no: ST-BMP che consente 
di iniettare più file in un 
unico file bmp, con tecni- 
ca RGB a 24 bit, o in un fi- 
le gif a 256 colori; ST- 
Wav che occulta mes- 
saggi all'interno di un file 
sonoro; interessante, in- 
fine, è ST-BMP che per 
nascondere le informa- 
zioni fa uso dei settori 
non utilizzati dei floppy. 
Questa ultima tecnica è 
resa possibile dall'analisi 
della FAT del dischetto. 
Ovviamente in questo ca- 
so un uso diverso dalla 
sola lettura per il floppy 
provocherebbe una pro- 
babile perdita delle infor- 
mazioni steganografate. 
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Permutazioni 
pseudocasuali 

\~J&\ Gli algoritmi con 
| < C7| permutazioni pseu- 
docasuali appartengono 
alla famiglia di LSB. Si 
basano sulla modifica dei 
bit meno significativi di 
file immagine o sonori. 
La differenza con i meto- 
di esaminati è nella scel- 
ta dei byte da modificare, 
che non viene fatta come 
una sequenza seppure 
random come nel caso di 
S-Tools, ma come la per- 
mutazione di un sottoin- 
sieme di tali byte. Una 
permutazione di n ogget- 
ti è la nuova disposizione 
degli stessi secondo un 
nuovo ordine. Il numero 
totale di permutazioni 
aumenta in modo espo- 
nenziale all'aumentare 
del numero di oggetti. In 
particolare le permuta- 
zioni di n oggetti sono n! 
(n fattoriale, si ricorda 
che il n!=n*(n-l)*(n- 
2)*..*1 e che il fattoriale 
di è 1). Scegliendo co- 
me successione di byte 
da modificare una per- 
mutazione del sottoinsie- 
me prescelto si perde la 
caratteristica di ordine, 
cosicché il messaggio se- 
greto viene "sparpaglia- 
to" tra i byte del messag- 
gio di copertura. La di- 
stribuzione non ordinata 
dei bit modificati tra i by- 
te disponibili fornisce un 
ulteriore elemento di si- 
curezza di prevenzione 
da eventuali attacchi. 



che ha prodotto il programma Stego, che al pa- 
ri di texto "genera" i messaggi steganografati, 
non utilizzando quindi oggetti di copertura 
dove iniettare il messaggio segreto. Si distin- 
gue da texto per la tecnica generativa usata, in 
questo caso infatti, si tratta di "imitare" lo sti- 
le di scrittura di un testo preso come riferi- 
mento. Si riscontrano in tale metodo tecniche 
proprie della linguistica computazionale, an- 
ch'essa trattate tra queste pagine qualche tem- 
po fa. Si estraggono dal testo di riferimento 
informazioni statistiche, come le occorrenze 
delle lettere e si produce il testo steganografa- 
to rispettando le stesse caratteristiche. Così 
però, si genera un testo che non ha un senso 
nemmeno a livello di parole, si parla infatti di 
pseudo parole. Una valida alternativa esamina 
come elemento di riferimento non le singole 
lettere ma parole o spezzoni di esse di lun- 
ghezza prefissata. In questo secondo caso si ot- 
tiene un testo corretto sintatticamente ma non 
semanticamente. 

La generazione del testo steganografato a par- 
tire dal testo di riferimento e dalle informazio- 
ni statistiche dello stesso non è banale. Si se- 
gue una filosofia simile adottata nel caso della 
generazione del codice Hufman, tecnica utiliz- 
zata per la compressione, con la quale si asso- 
ciano sequenze di bit di lunghezza diversa a 
seconda della frequenza delle singole parole o 
spezzoni di esse. Il software prodotto da Maz- 
zoleni è in grado di generare i testi anche sen- 
za alcun testo di riferimento, opzione molto 
comoda alcuni casi. Trovate il software, insie- 
me, a tutti gli altri citati nell'articolo, nella se- 
zione Soluzioni presente nel CD-Rom allegato 

TECNICHE 

DI WATERMARK 

E FINGERPRINT 

Per concludere esaminiamo alcune interessan- 
ti applicazioni della steganografia. Un uso si- 
gnificativo si ha nel campo dei diritti d'autore. 
Per preservare il copyright, sempre più autori 
appongono dei watermark alle proprie opere. 
Di cosa si tratta? Restringiamo l'osservazione 
al caso di opere intese come immagini digitali, 
ovviamente il discorso si può estendere anche 
ad altri tipi di produzione d'autore. Supponia- 
mo che un artista produca un ray tracing o co- 
munque un'opera che intende collocare sul 
mercato come file grafico, è naturale che le 
probabilità che l'opera sia appetibile si molti- 
plicano se essa è presente su un canale pubbli- 
co e molto frequentato, quale internet. Una ta- 
le politica rende l'opera maggiormente popo- 
lare ma inevitabilmente la sottopone al rischio 
di copia non autorizzata, con la conseguenza 



che prima o poi possa essere spacciata come 
originale. La presenza di un watermark garan- 
tisce circa la paternità dell'opera. Il ragiona- 
mento è semplice. 

Vengono più volte iniettate, all'interno del ray 
tracing, dei loghi o il nome dell'autore secon- 
do tecniche steganografiche, ad esempio con 
S-Tools. Così, si potrà in ogni momento ripor- 
tare in chiaro tali loghi attribuendo la pater- 
nità dell'opera al legittimo proprietario. La 
presenza di numerosi loghi iniettati salvaguar- 
da da eventuali ridimensionamenti e compres- 
sioni del file. 

Il fingerprint è una variante del watermark 
utilizzata per controllare diverse copie di uno 
stesso prodotto. Tale strumento è utile quando 
si vuole che la copia di un qualcosa, supponia- 
mo un software, rilasciata a pagamento o co- 
me copia di valutazione non vada in altre ma- 
ni. Si vuole evitare cioè che una sola licenza 
venga distribuita, con violazione dei diritti di 
autore e delle norme di rilascio del software, a 
più persone, ossia che sia installata su più 
macchine. In questo caso si allestisce una ta- 
bella con la quale si associa ad ogni copia rila- 
sciata un codice. 

Così il codice identificherà in modo univoco 
l'acquirente o comunque il beneficiario del 
software. Il codice viene iniettato sempre con 
tecniche steganografiche in alcuni dati appa- 
rentemente innocui associati al software, o che 
comunque abbiano altri scopi, come ad esem- 
pio immagini. Se quindi si riscontrano instal- 
lazioni con uguali fingerprint si deduce che al- 
cune copie sono state illecitamente distribuite, 
inoltre si può stabilire chi abbia prodotto la co- 
pia. Attenzione poiché la tecnica abbinata al- 
l'uso di internet permette alle case produttrici 
di software di controllare eventuali copie pira- 
ta. Come? Semplicemente prevedendo una 
funzione che si innesca quando si è connessi a 
internet che invia in modo nascosto i finger- 
print ai server della propria casa produttrice 
del software. 



CONCLUSIONI 

Sintetizzare la steganografia con soli due arti- 
coli è stato un compito molto arduo. Ho co- 
munque la presunzione di avere presentato gli 
aspetti salienti della tecnica e di avere analiz- 
zato le sfumature di maggiore interesse. Risul- 
ta evidente come sia attuale nell'ambito della 
sicurezza informatica. 

Quindi consiglio a chi si occupa di tale aspetto 
di approfondire l'argomento. Io intanto prepa- 
ro qualcosa di nuovo per il prossimo appunta- 
mento. Vi aspetto. 

Fabio Grimaldi 
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tf Robotica: Hardware e Software. 



Programmare un 
braccio meccanico 




In queste pagine vogliamo 

iniziare la costruzione di un 

braccio meccanico che sia in 

grado di manipolare oggetti di 

dimensioni e peso anche 

considerevoli. 



Le applicazioni dell'elettronica e dell' informatica 
ci hanno fatto abituare ad un mondo sempre 
più interconnesso e talvolta ad una certa astra- 
zione dei metodi di comunicazione che diventano 
sempre più 'tecnologici' e 'digitali'. Le applicazioni 
sorprendenti delle tecnologie orientate alla comunica- 
zione, possono, talvolta, fare passare in secondo piano 
le applicazioni orientate al controllo di sistemi 
hardware, la gestione dei quali diventa, giustamente, 
sempre più lontana dall'utente finale. 




Fig. 1: Nella figura è visibile la realizzazione 
completa, composta dalla mano meccanica e dal 
circuito elettronico realizzato con 
l'apparecchiatura PC Explorer light: il lettore ha 
tutte le informazioni per realizzare questo 
progetto anche con le tecniche costruttive 
convenzionali. 



Nell'intimo della parte 'hardwerista' del mio ego, in 
continua competizione con quella 'softwarista' rima- 
ne comunque il sogno di una apparecchiatura, che se 
vogliamo possiamo chiamare Robot, che ogni mattina 
mi porti la colazione a letto e che magari aiuti la mia 
consorte nei lavori di casa. Per fare contento mio fi- 



glio, magari potrebbe avere la forma di un robot dei 
più noti film, ma rigorosamente con capacità di mani- 
polare oggetti di dimensioni e peso considerevoli. Tut- 
to ciò è possibile e realizzabile da chiunque con un mi- 
nimo di attrezzatura e seguendo quanto riportato in 
queste pagine e negli appuntamenti futuri. Per chi 
avrà voglia di seguirmi in questa affascinante avven- 
tura, potremo realizzare inizialmente un vero braccio 
meccanico che poi potrà essere inserito in un vero e 
proprio Robot, in grado di muoversi, di evitare osta- 
coli e di portare a termine compiti sempre più com- 
plessi. Le applicazioni hardware a questo punto po- 
tranno fondersi con le più moderne ed avanzate tec- 
niche software, fino a portare ad una macchina sem- 
pre più versatile ed 'intelligente'. 



IL BRACCIO MECCANICO 

Il braccio meccanico che ci proponiamo di realizzare, 
una volta terminato sarà dotato di cinque gradi di li- 
bertà e potrà gestire la presa della mano, grazie a sen- 
sori di pressione: una serie di sensori infrarossi, inol- 
tre saranno in grado di verificare se l'oggetto da ma- 
nipolare è in posizione per la presa. Specificando me- 
glio cosa intendiamo per cinque gradi di libertà, pos- 
siamo dire che il nostro braccio sarà dotato di capacità 
di presa della mano, rotazione del polso, movimento 
del polso, movimento del gomito e rotazione della 
spalla, in analogia con un braccio umano. La gestione 
elettronica del braccio avverrà per mezzo della porta 
parallela di un PC, per mezzo di specifiche di inter- 




Fig. 2: Da una analisi dei dettagli costruttivi della 
mano meccanica, si nota che è completamente co- 
struita in alluminio, sono visibili l'attuatore della 
presa utilizzato in questa sede ed il servomeccani- 
smo deputato alla rotazione del polso che analizze- 
remo nei prossimi appuntamenti. 



C 

Elettronica e 

programmazione 



^ Filmati 
"W sul CD 

\soft\media\braccio 



^File sul CD 

\SOFT\CODICE\ 
SPUIMTO_Robot_Handl.zip 

<5v File sul Web 

www.ioprogrammo.net/ 
files/72/Robot_Hand.zip 



wi Bibliografia 

• CONTROLLIAMO LA 
PORTA PARALLELA CON 
DELPHI 6 
Luca Spuntoni 
(ioProgrammo N57-58) 
Aprile e Maggio 2002 



$: 



Il braccio 
meccanico 

Per maggiori infor- 
mazioni sul braccio 
meccanico, sulle interfac- 
ce relative e sull'apparec- 
chiatura 'PC Explorer li- 
ght' è possibile visitare il 
sito: 

http://web.tiscali.it/ 
spuntosoft/ 

oppure scrivere all'indi- 
rizzo: 

luca.spuntoni(g)edmaster.it 
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I componenti 
necessari 

^a • 4 transistors 
<J 2N1711 o BC141 

• 4 Resistenze da 1 K 
Ohm _ watt 

• 1 motore CC per hobbi- 
stica. 



facciamento che verranno fornite di volta in volta. In 
questa sede analizzeremo come gestire la presa della 
mano meccanica: per ottenere maggiori dettagli co- 
struttivi meccanici della realizzazione, che esulano 
dallo scopo di queste pagine, si consiglia di visitar il 
sito: http://web.tiscali.it/spuntosoft/' , oppure di contatta- 
re direttamente l'autore all'indirizzo di posta elettro- 
nica: luca.spuntoni@edmaster.it. 

LA PRIMA REALIZZAZIONE: 
AZIONIAMO LA MANO 
MECCANICA 

La mano meccanica, per essere in grado di manipola- 
re oggetti di volume e peso consistenti deve essere 
azionata da un servocomando di potenza adeguata, 
nonché essere costruita in un materiale idoneo a ma- 
neggiare anche cose di composizione e caratteristiche 
fisiche diverse. 

Per la nostra realizzazione è stata progettata una ma- 
no costituita da due dita, costruita in alluminio e di di- 
mensioni paragonabili ad una mano umana, ovvia- 
mente fatte le dovute distinzioni. 
L'attuatore elettromeccanico è un comune motore in 
corrente continua da 6 Volts, dotato di motoriduttore 
1:120; deve essere detto che il rapporto di riduzione 
definisce in pratica, a parità di potenza del motore, la 
forza massima esercitabile con la mano, che ovvia- 
mente deve essere proporzionale al peso ed alle carat- 
teristiche fisiche dell' oggetto da manipolare. 
Il rapporto di riduzione definisce anche la velocità di 
apertura e di chiusura della mano, ma questo è un pa- 
rametro secondario: le considerazioni di progetto im- 
portanti sono piuttosto orientate ad una corretta ma- 
nipolazione degli oggetti, dal momento che la presa 
deve essere sufficiente a non fare cadere l'oggetto, ma 
non troppo forte da romperlo: penso infatti che mia 
moglie si sarebbe un poco alterata se le avessi frantu- 
mato la tazzina di porcellana di Fig. 3. 




Fig. 3: La mano meccanica è stata progettata in 
modo tale che possa maneggiare oggetti di peso e 
dimensioni ragguardevoli: nella figura si nota il 
meccanismo in azione con una comune tazza da 
caffè. 

Per quanto riguarda Y hardware di gestione, consiglio 
come al solito di non utilizzare il computer nuovo di 
zecca appena acquistato. 

L'utilizzo di un vecchio PC, magari dotato di Win95 è 
l'ideale per la sperimentazione elettronica e per la rea- 
lizzazione di apparecchiature di controllo, in modo da 



non rischiare la Vita' di macchine più nuove e pregia- 
te: un PC 486 o Pentium può essere acquistato per po- 
che decine di euro e garantisce ottime potenzialità dal 
punto di vista della sperimentazione. 

IN FUTURO: I SENSORI 

DELLA PRESA E 

LA ROTAZIONE DEL POLSO 

Nei prossimi appuntamenti termineremo la mano 
meccanica, conferendole la sensibilità tattile per mez- 
zo di sensori di pressione posti sulle dita, posizionere- 
mo e gestiremo inoltre dei sensori ad infrarossi per la 
verifica del corretto posizionamento dell'oggetto da 
manipolare. 

Terminata la mano conferiremo al braccio il resto del- 
le capacità di movimento: la rotazione del polso, il 
movimento del polso, il movimento del gomito e ro- 
tazione della spalla. 

Terminato il braccio meccanico, potremo iniziare a 
sviluppare il resto del Robot, capace di muoversi agil- 
mente, fungere da guardiano e maggiordomo di casa. 

L'INTERFACCIA 
ELETTRONICA 

Il problema che dobbiamo risolvere per rendere pos- 
sibile il movimento della nostra mano meccanica è 
semplicemente quello di azionare il motore in corren- 
te continua, dotato di motoriduttore rendendone pos- 
sibile la rotazione nei due sensi (apertura e chiusura), 
nonché gestirne lo stato di arresto ed il fine corsa. Per 
quanto riguarda queste ultime caratteristiche, pos- 
siamo dire che esistono vari modi per implementarle 
e le possibili soluzioni verranno presentate nel prossi- 
mo appuntamento. 

Per quanto riguarda il movimento del motore, confe- 
riamo a due bit della porta Dati della porta parallela e 
per la precisione al bit DO e DI, il compito di definire 
lo stato di Stop il Movimento di apertura ed il Movi- 
mento di chiusura. 

Quando il livello logico sulla linea DO sarà ALTO, cioè 
+5V, il motore ruoterà in senso orario, causando l'a- 
pertura della mano, analogamente, quando il livello 
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Fig. 4: Lo schema elettrico del circuito necessario 
al controllo della mano meccanica è stato inserito, 
per comodità del lettore nel file incluso al CD 
(SPUNTO_Robot_Hand.zip) con il nome: 
Schema_ elettrico_Mano. bmp . 
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logico sulla linea DI sarà ALTO, il motore ruoterà in 
senso anti- orario, causandone la chiusura. 
Durante le operazioni di apertura e chiusura l'altra li- 
nea dovrà essere a livello BASSO, cioè alla massa lo- 
gica. 

Gli stati corrispondenti ad entrambe le linee a livello 
ALTO od entrambe a livello BASSO causano l'arresto 
del motore, però di queste condizioni, soltanto quella 
relativa alle due linee a livello logico BASSO viene uti- 
lizzata come STOP del motore, per evitare l'inutile 
conduzione contemporanea dei quattro transistor. 
Osservando lo schema elettrico, che per comodità del 
lettore viene incluso nel file contenuto nel CD allega- 
to alla rivista, notiamo che quando entrambe le linee 
DO e DI hanno lo stesso stato logico, quindi BASSO, 
come abbiamo detto in precedenza, nessun transistor 
è in conduzione, dal momento che la differenza di po- 
tenziale tra ciascuna base ed emettitore è nulla, di con- 
seguenza ad entrambi i capi del motore si trova una 
tensione nulla ed il motore è fermo. 
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Fig. 5: Lo stato logico delle linee DO e DI 
determinano lo stato di apertura, chiusura o 
fermo della mano meccanica. 

Quando una delle linee è a livello ALTO, sulla base dei 
transistor ad esso collegati, attraverso le apposite resi- 
stenze di carico, si troverà ( senza scendere in dettagli 
di progetto che sarò felice di approfondire con i letto- 
ri interessati) una tensione sufficiente a portare i tran- 
sistors in conduzione, annullando (o quasi) la diffe- 
renza di potenziale tra i rispettivi collettori ed emetti- 
tori. 

Questa situazione porterà a determinare una differen- 
za di potenziale ai capi del motore e ne determinerà il 
senso di rotazione causando l'apertura o la chiusura 
della mano. 

I transistor scelti nella applicazione (2N 1711 o BC141) 
sono sufficienti per piccoli motori: è buona norma do- 
tarli comunque di aletta di raffreddamento: nel caso di 
motori più grandi si consiglia di preferire transistor in 
configurazione Darlington oppure appositi circuiti in- 



tegrati di potenza. Il dimensionamento dei circuiti in 
questo caso dovrà essere fatto in modo adeguato, per 
non assorbire troppa potenza dalla porta parallela del 
PC, con un possibile rischio di danneggiarla. 

REALIZZAZIONE 

DEL CIRCUITO ELETTRICO 

Per realizzare il circuito appena descritto a livello teo- 
rico, è consigliabile di procedere con ordine, iniziando 
ad eseguire per primi i cablaggi di tutte le linee di con- 
nessione, come indicato nella fotografia che segue. 
Nell'immagine si notano, in alto a sinistra, le due con- 
nessioni alle linee della porta parallela DO e DI, non- 
ché le resistenze di carico dei quattro transistor. 
Si consiglia di eseguire i cablaggi con spezzoni di filo 
di colore appropriato, in modo da facilitare la ricerca 
degli errori. 

Il cablaggio può essere eseguito facilmente utilizzan- 
do l'apparecchiatura mostrata in figura, chiamata 'PC 
Explorer light', la più semplice della famiglia 'PC Ex- 
plorer' , sulla quale è possibile avere maggiori informa- 
zioni sul sito 'http://web.tiscali.it/spuntosoft/' . 
Terminati i cablaggi, ai quali in modo opzionale si 
possono aggiungere i collegamenti ai due LED 1 e 2 
come mostrato in figura, per monitorizzare lo stato 



PC Explorer à$4r 




Fig. 6: Il cablaggio iniziale procede innanzi tutto 
posizionando le quattro resistenze e tutte le 
connessioni elettriche, come riportato nella foto di 
figura, maggiori informazioni sono reperibili sul il 
sito: ' http://web.tiscali.it/spuntosoft/' . 
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Apparecchiature 
per montaggi 
sperimentali 

*& Il sistema proposto 
vj/ in queste pagine è 
stato realizzato e collau- 
dato con la apparecchia- 
tura per il collaudo e la 
sperimentazione di cir- 
cuiti elettronici con Per- 
sonal Computer 'PC EX- 
PLORER light': ulteriori 
informazioni su come si 
possa reperire questa ap- 
parecchiatura è possibile 
visitare il WEB all'indiriz- 
zo: 



U 



http://web.tiscali 
spuntosoft/ 



oppure scrivere all'indi- 
rizzo: spuntosoft(5)tiscali.it 
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Il software 

r% Il software di con- 
^^ trollo è stato collau- 
dato con Win 3.x, Win 9x 
e Win Me, se si utilizza 
Win 2000, oppure NT, 
occorre scrivere una par- 
te di codice che gestisce 
i privilegi del sistema, 
per non incorrere in un 
errore del tipo 'Privile- 
ged error'. 



delle linee DO e DI, possiamo procedere ad inserire i 
quattro transistors, facendo attenzione ad orientarli 
correttamente secondo quanto riportato in Fig.7. 
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Fig. 7: Terminato il cablaggio, siamo pronti ad 
inserire i quattro transistor, facendo attenzione 
che le tacche indicanti l'emettitore siano 
posizionate come in figura. 



A questo punto siamo pronti per collegare i terminali 
del motore della nostra mano meccanica, come mo- 
strato qui di seguito dai fili rosso e blu che escono dal- 
la breadboard: i fili possono essere invertiti se il verso 
di rotazione del motore, per un dato comando non è 
quello desiderato. 

Occorre specificare che chi voglia costruire questa ap- 
plicazione direttamente su circuito stampato, oppure 
con una piastra millefori, od ancora con una comune 
breadboard, può farlo seguendo lo schema elettrico 
riportato in questa sede e consultando le fotografie re- 
lative per verificare la correttezza dei cablaggi. 




Fig. 8: In figura si ha un particolare del circuito 
elettronico di controllo che è facilmente 
realizzabile con l'apparecchiatura PC Explorer 
light: è possibile cablare il circuito, in alternativa, 
utilizzando una comune piastra millefori ed i pochi 
componenti elencati a lato dell'articolo. 



IL SOFTWARE 
DI CONTROLLO 

Il programma di controllo è scritto in Delphi, ma può 
essere tranquillamente trasportato in qualunque altro 
linguaggio con poche modifiche. 
Nell'intestazione della unit principale notiamo che il 
programma utilizza in particolare SpuntoLedCompo- 
nent e UnitPortaPar alleici, dei quali vengono forniti i fi- 
les già compilati e pronti all'uso nel CD incluso alla ri- 
vista: di tutte le altre componenti del programma vie- 
ne fornito il codice completo: 



// 






II 



II 



II 



Il TSpuntoROBOTHand Delphi 6 Application Ver 1.0 // 
// Copyright 2003 Luca Spuntoni Jun. 2003 // 



// 



spuntosoft@tiscali.it 



// 



// 



// 






unit SpuntoROBOT_Hand_Unitl; 



interface 



Windows, Messages, Syslltils, Variants, Classes, 
Graphics, Controls, Forms,Buttons, 

Dialogs, ExtCtrls, Menus, StdCtrls, 
SpuntoLedComponent, UnitPortaParallela, 

UnitAbout, Spin, Math, jpeg; 

La classe principale, ingloba tutte le funzionalità prin- 
cipali del programma, in particolare notiamo Y ogget- 
to TTimer, che ogni 0,5 secondi provvede a gestire il 
movimento della mano: 

type 

//%• ^^^ >fc5fc>fc >^^^ sfcsfcsfc ^^ >k Msjn Class ^^^%-^^^%-%-%-^^x-^^^ / / 

TSpuntoROBOTHand Form = class(TForm) 

StepperMotorPanel: TPanel; 

MainMenul: TMainMenu; 

Filesl: TMenuItem; 

Exitl: TMenuItem; 

ParallelManagerl: TMenuItem; 

ShowManagerl: TMenuItem; 

Aboutl: TMenuItem; 

Labell: TLabel; 

Label2: TLabel; 

MoveHandCheckBox: TCheckBox; 

DirectionGroupBox: TGroupBox; 

OpenRadioButton: TRadioButton; 

CloseRadioButton: TRadioButton; 

ContinuousMonitoringCheckBox: TCheckBox; 

Imagel: TImage; 

Image2: TImage; 

Image3: TImage; 

Timerl: TTimer; 

procedure ShowManagerlClick(Sender: TObject); 
procedure ExitlClick(Sender: TObject); 



procedure AboutlClick(Sender: TObject); 
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procedure FormShow(Sender: TObject); 

procedure FormCreate(Sender: TObject); 

procedure H and Action; 

procedure StopHand; 

procedure CloseHand; 

procedure OpenHand; 

procedure DelaytoStepTimerTimer(Sender: TObject); 
procedure ContinuousMonitoringCheckBoxClick( 

Sender: TObject); 

procedure WritePort(PortAddress, PortData:word); 
procedure MoveHandCheckBoxClick(Sender: TObject); 



procedure OpenRadioButtonDblClick(Sender: TObject); 
procedure CloseRadioButtonClick(Sender: TObject); 



procedure TimerlTimer(Sender: TObject); 



private 



{ Private declarations } 



public 



{ Public declarations } 



end; 



L'azionamento della mano viene controllata dalla 
procedura che segue, che verifica innanzi tutto se la 
mano debba essere mossa o meno e poi stabilisce in 
quale direzione, a questo punto chiama OpenHand per 
l'apertura e CloseHand per la chiusura. 
Infine, se il movimento della mano deve essere arre- 
stato, viene chiamato StopHand. 

procedure TSpuntoROBOTHandForm.HandAction; 

// Controls the ROBOT's Hand 



Begin 


If MoveHandCheckBox.Checked then begin 


If CloseRadioButton.Checked then CloseHand 

else OpenHand; 


End 


Else Begin 


If SpuntoRobotHandForm.Visible then 


StopHand; 


End; 




* ì 
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End; 



SpuntoROBOTHandForm: TSpuntoROBOTHandForm; 




Warning: Use this program and this circuit at your own risk:a wrong use may damage your system. 
Read the 'Licence and Disclaimer' file before usinq it. SpuntoSoft@tiscali.it 
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Fig. 9: All'esecuzione del programma si ha la 
schermata visibile in figura: i controlli disponibili 
permettono l'apertura e la chiusura della mano 
meccanica. 



Nella parte Implementation della Unii analizziamo una 
alla volta tutte le procedure: dopo la creazione della 
form, viene lanciata l'esecuzione di FormCreate, che 
provvede, semplicemente, a predisporre i paramenti 
relativi allo stato iniziale delle checkbox della finestra: 



implementation 



{$R*.dfm} 



procedure TSpuntoROBOTHandForm. FormCreate( 
Sender: TObject); 



begin 



//Inizializzazione Stato dei componenti sulla Form 

principale 

MoveHandCheckBox.Checked: = False; 

ContinuousMonitoringCheckBox.Checked: = False; 

CloseRadioButton.Checked :=True; 



Le procedure OpenHand, CloseHand e StopHand sono 
fondamentali, come è intuibile dal loro nome, per il 
movimento della mano: in pratica all'interno di que- 
ste procedure viene stabilito come debbano essere im- 
postati i bit DO e DI della porta parallela, prima che 
venga chiamata la procedura Writeport, che scrive fi- 
sicamente il dato così ottenuto sulla porta. 

procedure TSpuntoROBOTHandForm. StopHand; 

// Stops the hand movement 

Var 

W,MyPortAddress:Word; 

Begin 



MYPortAddress: 



W:=0; 



= FormPortaParallela.StepperMotorPorta 

Parallela .SpuntoPortDataAddress; 

// Bit Do e DI della porta=Q 



WritePort(MyPortAddress,W); 



End; 



procedure TSpuntoROBOTHandForm. CloseHand; 
// Closes the hand 



Var 



W,MyPortAddress:Word; 



Begin 



MYPortAddress: 



W: = 2; 



= FormPortaParallela.StepperMotorPorta 

Parallela .SpuntoPortDataAddress; 

// Bit DI della porta = l 



WritePort(MyPortAddress,W); 



End; 



procedure TSpuntoROBOTHandForm. OpenHand; 
// Opens the Hand 



Var 



W,MyPortAddress:Word; 



Begin 



MYPortAddress: = Form PortaParallela.StepperMotorPorta 
Parallela .SpuntoPortDataAddress; 



end; 



W: = l; 



// Bit DO della porta = l 



Open Hand 
e Stop Hand 

& Le procedure Open- 
^J Hand, CloseHand e 
StopHand sono fonda- 
mentali, come è intuibile 
dal loro nome, per il mo- 
vimento della mano: in 
pratica all'interno di 
queste procedure viene 
stabilito come debbano 
essere impostati i bit DO 
e DI della porta paralle- 
la, prima che venga chia- 
mata la procedura Wri- 
teport, che scrive fisica- 
mente il dato così otte- 
nuto sulla porta. 
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WntePor-t(MyPortAddress,W); 



HandAction; 



* i 
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L'autore 

y-% Luca Spuntoni si oc- 
^ cupa da un decennio 
di interfacciamento di 
microprocessori e di svi- 
luppo di applicazioni per 
l'ottimizzazione dei pro- 
cessi. 



End; 

La scrittura sulla porta parallela, e per la precisione 
sul byte Dati di questa periferica, avviene per mezzo 
del semplice codice assembler che viene riportato di 
seguito: il cardine è l'istruzione OHI, che permette la 
scrittura diretta su un indirizzo fisico di I/O della 
porta: 

procedure TSpuntoROBOTHandForm.WritePort( 

PortAddress, PortData:word); 

// Write PortData over PortAddress if Port Writing 

is enabled 

begin 

PortData := (PortData*256)+PortData; 

asm 

Mov ax,PortData 

Mov dx, PortAddress 

Out dx,ax 

end; 

end; 



Come dicevamo all'inizio di questo paragrafo, un ti- 
mer innesca ogni 0,5 secondi il controllo della mano, 
questo viene fatto dalla procedura che segue, che 
provvede a richiamare appunto HandAction. 

procedure TSpuntoROBOTHandForm.DelaytoStepTimerTimer( 

Sender: TObject); 

begin 

HandAction; 

end; 

Le procedure che seguono sono tutte event handler 
dei comandi deputati al controllo della mano: sempli- 
cemente provvedono a chiamare HandAction ogni 
qualvolta viene fatto click per cambiarne lo stato: 



end; 



procedure 


TSpuntoROBOTHandForm.MoveHandCheckBoxClick( 
Sender: TObject); 


begin 


HandAction; 


end; 


procedure 


TSpuntoROBOTHandForm.OpenRadioButtonDblClick( 
Sender: TObject); 


begin 


HandAction; 


end; 


procedure 


TSpuntoROBOTHandForm.CloseRadioButtonClick( 
Sender: TObject); 


begin 


HandAction; 


end; 


procedure TSpuntoROBOTHé 


ìndForm.TimerlTimer( 

Sender: TObject); 


begin 
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Fig. 10: Attivando il 'Parallel Port Manager', con il 
comando relativo, è possibile visualizzare lo stato 
completo di tutte le linee della porta parallela: per 
maggiori informazioni consultare l'articolo: 
"Controlliamo la porta Parallela con Delphi 6", 
pubblicato su ioProgrammo N57-58 Aprile e 
Maggio 2002. 

Con questo programma è possibile monitorare, a li- 
vello di bit, lo stato dei tre byte di stato della porta pa- 
rallela, leggendoli direttamente a livello hardware; 
questo può essere fatto lanciando le procedure che se- 
guono, che provvedono a rendere visibile od a na- 
scondere la form FormPortaParallela. 

procedure TSpuntoROBOTHandForm. 
ContinuousMonitoringCheckBoxClick(Sender: TObject); 

begin 

Form PortaParallela.StepperMotorPorta Parallela. 

SpuntoContinuousMonitoring: = 

ContinuousMonitoringCheckBox.Checked; 

If ContinuousMonitoringCheckBox.Checked Then 

FormPortaparallela.Show else 

FormPortaparallela.Hide; 

end; 

procedure TSpuntoROBOTHandForm. ShowManagerlClick( 

Sender: TObject); 

begin 

ContinuousMonitoringCheckBox.Checked : =True; 

FormPortaParallela. Show; 



Form PortaParallela.StepperMotorPorta Parallela. 

SpuntoContinuousMonitoring: = 
ContinuousMonitoringCheckBox.Checked; 



end; 



La form About viene resa visibile in modalità modal 
quando l'utente sceglie l'opzione 'About', oppure al- 
l'avvio del programma, prima della visualizzazione 
della finestra principale: 

procedure TSpuntoROBOTHandForm. AboutlClick( 

Sender: TObject); 

begin 

SpuntoAbout.ShowModal; 
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end; 


procedure TSpuntoROBOTHandForm.FormShow(Sender: 

TObject); 


begin 


SpuntoAbout.ShowModal; 


end; 


Infine per terminare il programma viene 
procedura che segue: 


eseguita la 


procedure TSpuntoROBOTHandForm.ExitlCI 


ck(Sender: 
TObject); 


begin 


SpuntoRobotHandForm.Close; 


end; 



Il programma Delphi, descritto in precedenza, ha la 
caratteristica di accedere all'hardware del PC attra- 
verso i propri indirizzi fisici di I/O, questa tecnica, 
dal momento che scavalca il sistema operativo, po- 
trebbe 'non piacere' a Windows NT, 2000, oppure XP, 
pertanto si consiglia di utilizzare un calcolatore dota- 
to di Win 3.X, Win 9X, oppure Millennium. 
In alternativa, occorre scrivere una parte di codice che 
gestisca i privilegi del sistema, per non incorrere ad 
un errore del tipo 'Privileged error' . 




Fig. 11: La mano meccanica è costituita da un 
azionatore dotato di un comune motore a 
corrente continua demoltiplicato in un rapporto 
1:120, maggiori informazioni ed una 
documentazione completa dei dettagli meccanici 
sono disponibili sul WEB all'indirizzo: 
h ttp://web. fiscali . it /spuri tosoft/. 



COLLAUDO DEL SISTEMA 

Innanzi tutto, prima di collegare il circuito al nostro 
PC, occorre verificare la nostra realizzazione con at- 
tenzione per assicurarci che tutto sia stato collegato 
come previsto. 

Colleghiamo al nostro circuito il cavo relativo alla 
porta parallela del PC, se possediamo PC Explorer co- 
me mostrato in figura, oppure provvedendo a co- 
struirci un cavo seguendo lo schema elettrico e la ta- 
bella riportatinei paragrafi precedanti. 




Fig. 12: Dopo avere terminato l'assemblaggio del 
circuito, siamo pronti a collegare un comune cavo 
parallelo alla nostra apparecchiatura, oppure nel 
caso in cui il circuito sia stato autocostruito siamo 
pronti a collegarlo alla porta parallela del PC. 



Accendiamo il PC, lanciamo il programma di gestio- 
ne e forniamo alimentazione al circuito: a questo pun- 
to cliccando sui comandi di apertura e chiusura do- 
vremmo vedere la nostra mano muoversi. Nel caso in 
cui l'azionatore si muova in direzione opposta al pre- 
visto, provvediamo semplicemente a scambiare le 
connessioni del motore. Il circuito funziona anche per 
comandare un comune motore in corrente continua 
per altre applicazioni: si raccomanda di dimensionare 
i transistor in modo adeguato, per non sovraccaricare 
la porta parallela, cosa che comporterebbe qualche ri- 
schio di danneggiamento del PC. 
Se il circuito non funziona, provvediamo a spegnere 
tutto prima di ricontrollare i collegamenti e riprovare 
di nuovo. 



CONCLUSIONI 

In queste pagine abbiamo visto come controllare il 
movimento di una mano meccanica azionata da un 
motore in corrente continua: il progetto dello schema 
elettrico, tutti i collegamenti necessari, il software 
compilato ed i relativi codici sorgenti sono stati messi 
a completa disposizione del lettore. 
Il lettore vorrà comprendere che nonostante quanto 
esposto in queste pagine sia stato debitamente verifi- 
cato e collaudato, tuttavia viene riportato a scopo il- 
lustrativo e di studio, pertanto l'editore e l'autore non 
sono da considerare responsabili per eventuali conse- 
guenze derivanti dell'utilizzo di quanto esposto in 
questa sede, soprattutto per la tipologia e la comples- 
sità dell' argomento. 

Per maggiori informazioni sul braccio meccanico, sul- 
le interfacce relative e suir apparecchiatura 'PC Explo- 
rer light' è possibile visitare il sito '/http: //web. tiscali.it/ 
spuntosoft/' ', inoltre l'autore è lieto di rispondere ad 
ogni richiesta di chiarimento o delucidazione sull'ar- 
gomento all'indirizzo di posta elettronica luca.- 
spuntoni@edmaster.it. 

Luca Spuntoni 
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Precauzioni 

Prima di collegare il 
circuito al nostro PC 
occorre verificare la no- 
stra realizzazione con 
attenzione per assicu- 
rarci che tutto sia stato 
collegato come previsto. 
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Flash 



rf Servizi multimediali con Flash Mx e Web Service. 

Previsioni 
meteo animate 



Macromedia Flash Mx e i Web 

Service alfieri della nuova 

programmazione orientata a 

Internet si candidano 

prepotentemente a guidare 

questa rivoluzione. Scopriamo 

la potenza della loro unione. 



guaggio interno di Flash, "cugino" di ECMA script, 
padre dei moderni linguaggi di script. Per rendere Fi- 
dea, considerate di avere un metodo sul server (scrit- 
to quindi in Java o .NET) che si chiama getNameO che 
restituisce una stringa dopo una connessione al data- 
base. Con Flash MX, tramite Actionscript lo invocate 
semplicemente con oggettoService. getNameO, ottenen- 
do il risultato in una funzione di callback che si chia- 
ma getN ame _r esuli. 



File sul CD^ 

\soft\codice\Meteo.zip 



File sul Web HT 

www.ioprogrammo.net 
/files/72/Meteo.zip 



Macromedia 
Flash Remoting 

r-A Macromedia Flash 
tj Remoting consente 
agli sviluppatori ColdFu- 
sion di rendere facilmen- 
te disponibili servizi re- 
moti ai client Macrome- 
dia Flash. Utilizzando 
ColdFusion Components 
o il nuovo supporto per 
ActionScript sul versante 
server, gli sviluppatori 
che hanno familiarità con 
ColdFusion o Macromedia 
Flash possono facilmente 
creare applicazioni che 
uniscono la sensibilità e 
la funzionalità di applica- 
zioni client/server con i 
bassi costi di sviluppo 
consentiti da Internet. 
Incluso come servizio 
nativo in ColdFusion MX, 
Macromedia Flash Remo- 
ting supporta anche le 
connessioni dirette con i 
client Macromedia Flash 
Player sia verso i compo- 
nenti .NET, che J2EE. 



I vantaggi dei Web Service sono evidenti: sono in- 
dipendenti dalla piattaforma, sono trasparenti per 
i firewall e sono versatili.Già adesso stiamo assi- 
stendo a una convergenza delle tecnologie dei portali 
con le architetture basate sui Web Service. Complesse 
architetture possono essere suddivise in piccoli ogget- 
ti modulari, che possono essere condivisi e riutilizzati 
da utenti autorizzati o da agenti intelligenti. Queste 
caratteristiche permettono di creare framework come 
se si stesse disegnando un sistema OOP. Come risul- 
tato, ad esempio, un'azienda potrebbe introdurre un 
nuovo prodotto senza dover riconfigurare la tecnolo- 
gia esistente, in quanto i moduli di processo basati sui 
servizi verrebbero riutilizzati per aggiungerlo all'in- 
frastruttura. Riutilizzando servizi già pronti, il costo e 
il tempo necessari a integrarsi con nuovi sistemi, o 
compiere dei cambiamenti su quelli esistenti, dovreb- 
be ridursi significativamente. Flash MX è comodo per- 
ché permette di creare animazioni usabili ed ergono- 
miche, caratterizzate da layout accattivanti e d'impat- 
to grazie al rendering di grafica vettoriale. Chi è abi- 
tuato a sviluppare codice HTML è alle prese con pro- 
blemi di compatibilità fra i vari browser: Flash MX ga- 
rantisce invece un ottimo supporto cross-browser. Ciò 
significa che una volta che il movie sarà completato, 
esso sarà visibile allo stesso modo su qualsiasi client e 
su ogni piattaforma. Ma tutto questo è il meno: c'è 
molto di più! La grande cosa che ci permette Flash MX 
è di usare Remoting MX. La straordinarietà di Remo- 
ting è che ci fa invocare dei metodi direttamente sul 
server, catturandone il risultato senza nessun parsing 
particolare da parte nostra. In pratica, possiamo co- 
municare direttamente con ColdFusion MX (che usia- 
mo nel nostro esempio) o con server Java o .NET. Il 
tutto soltanto con qualche riga di Actionscript, il lin- 



MIRACOLI 

DELLA SERIALIZZAZIONE! 

Ciò apre le porte a un ordinato e vantaggioso uso del- 
la programmazione OOP tramite Actionscript appli- 
cando così alle nostre architetture anche i più utili de- 
sign pattern. Il tutto diminuendo la banda utilizzata 
poiché il Remoting MX prevede una comunicazione 
client-server secondo il formato AMF (Action Message 
Format), che è binario e compresso. Niente male per 
uno strumento praticamente utilizzabile dalla stra- 
grande maggioranza dei client. Web Service e Flash 
MX vanno a braccetto permettendo di realizzare una 
perfetta scalabilità, e rendendo così l'azienda agile e 
flessibile nei cambiamenti. Entrambi usano il protocol- 
lo HTTP raggiungibile sulla porta 80 e sono modellati 
su soap. Lavorando su progetti di dimensione almeno 
media, spesso si incontrano notevoli difficoltà e pro- 
blemi legati alla sicurezza, quando fra client e server si 
frappongono firewall e proxy. E un problema che in 
genere affligge altri standard come CORBA, DCOM e 
RMI. Fortunatamente a noi va bene perché la porta 80 
risulta sempre aperta. Vediamo ora quali passi dobbia- 
mo seguire per invocare un Web Service remoto e ma- 
nipolarne la risposta da flash. Realizziamo un movie 
che ci informa sul meteo in tutto il mondo. 



PREPARIAMO L'AMBIENTE 

Come detto, Flash Remoting può comunicare con il 
server in modo diretto tramite Remoting. Sul server 
andremo ad installare ColdFusion MX (presente nel 
CD allegato al numero 71 di ioProgrammo e scarica- 
bile dal sito ufficiale di Macromedia in prova all'indi- 
rizzo http://www.macromedia.com/software/coldfusion/ 
trial/) che è di immediata installazione, non richiede 
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nessuna configurazione, basta solo lanciare il setup, 
leggere le informazioni che si presentano e scegliere 
avanti, avanti... fine. Sia ben chiaro che non scrivere- 
mo nessuna riga di codice lato server, esso fungerà 
soltanto come una specie di proxy. Il servizio di Flash 
Remoting non deve essere configurato poiché è in- 
stallato automaticamente con ColdFusion MX. Una 
volta sistemato ColdFusion, vanno installati lato 
client i Flash MX Remoting Components , un piccolo 
pacchetto scaricabile dal sito macromedia all'indiriz- 
zo http://www.macromedia.com/software/flashremoting 
/downloads/ components/ che si integra con l'ambiente 
Flash MX. In particolare fornisce dei file che vanno 
importati neiractionscript, essi sono: 

• "NetServices.as" che espone una serie di oggetti e 
metodi che permettono di usare Remoting. 

• "NetDebug.as" che permette di utilizzare un vali- 
do strumento di debug. 

• "DataGlue.as" che binda un dataprovider (ad es 
un recordset) a un oggetto che lo visualizza (es 
combobox). 

DESCRIZIONE 

DEL NOSTRO WEB SERVICE 

Vi sono molti web service disponibili gratuitamente in 
rete, noi andremo a invocarne uno che offre dei report 
sullo stato meteorologico in molte città del mondo: 

http://www.webservicex.net/globalweather.asmx ? WSDL 

Per le vostre prove dovrete quindi essere connessi in 
rete. Esso, oltre ad essere gratuito, ben si presta ad es- 
sere analizzato in quanto dà un tipo di risposta molto 
utile a fini didattici. Esso espone questi metodi: 

GetCitiesByCountryO, che restituisce tutte le città 
principali di un paese specificato, rispondendo in 
questo modo: 

<NewDataSet> 

<Table> 

<Country>paese scelto</Country> 

<City>cittal</City> 

</Table> 

<Table> 

<Country> paese scelto </Country> 

<City>citta2</City> 

</Table> 



<CurrentWeather> 



< Location >città </Location > 



<Time>informazioni orarie</Time> 



<Wind> direzione e velocità del vento</Wind> 

<Visibility> distanza visibilità</Visibility> 

<Temperature> dati temperatura </Temperature> 
< SkyConditions> condizione del cielo</ SkyConditions > 
< Relati veHumidity> percentuale umidità 
</RelativeHumidity> 



<Pressure> pressione atmosferica</Pressure> 
<Status>esito operazione</Status> 



</NewDataSet> 



</CurrentWeather> 

Come risposta avremo solo i nodi disponibili, per cui 
alcuni potrebbero non essere ricevuti. 

COSTRUIAMO 
IL MOVIE FLASH 

Il movie flash che andiamo a costruire contiene solo 
qualche componente e poche righe di codice Action- 
script. Lanciate Flash MX e create un nuovo movie. 
Inserite nello stage due combobox. Alla prima asse- 
gnate il nome di istanza countries_cb e alla seconda 
city_cb. Aggiungete un PushButton, chiamatelo re- 
port btn e come click handler settate callVSfeather Service, 
la funzione Actionscript che chiederà il report. Selezio- 
nate "countries_cb" e, dal pannello delle properties, 
valorizzate label e data della combobox, inserendo i 
nomi degli stati che vi interessano. Dal pannello, inol- 
tre, settate il change handler della combo a "getdty" o a 
una di vostra scelta. Tramite questo handler possiamo 
eseguire una funzione personale quando selezionia- 
mo una nuova voce: nel nostro caso, ogni volta che 
scegliamo uno stato diverso, dobbiamo chiedere al 
Web Service di fornirci la lista di città di cui dispone 
di report. La lista ricevuta verrà caricata sulla combo 
city_cb in modo dinamico, tramite Actionscript, set- 
tando un dataProvider oppure eseguendo degli addl- 
tem. Lascio a voi la gioia di inserire qualche bello sfon- 
do, o effetto animato che più vi aggrada, per rendere 
gradevole il movie. A questo punto, per maggior or- 
dine aggiungete un layer e chiamatelo "acts" . Nel pri- 
mo frame di questo livello andrà inserito il codice Ac- 
tionscript. In Fig. 1 potete osservare una schermata su 
come organizzare il movie. Dopo aver incluso i file 
che ci permettono di usare Remoting (è necessario so- 
lo NetServices.as una volta che il movie viene compila- 
to per il server di regime), per poter chiamare un web 
service o una procedura remota in Actionscript, basta 
seguire questi passi: 

1) Si specifica e ci si connette al gateway, ottenendo 
un oggetto NetConnection: 




Flash 



Previsioni 

meteo animate 



ColdFusion MX 
e Web Service 

/-& "Le funzionalità Web 
--^ service e XML di 
ColdFusion MX sono estre- 
mamente potenti, permet- 
tendo di realizzare in tem- 
pi brevi ciò che altre tec- 
nologie richiederebbero 
naggiore tempo di svilup- 
po. 

Utilizzando le nuove e ri- 
voluzionarie funzionalità 
di ColdFusion Components 
integrate in ColdFusion 
MX, gli sviluppatori posso- 
no facilmente incapsulare 
e riutilizzare il codice per 
creare applicazioni ben 
strutturate che possono 
essere consultate automa- 
ticamente come Web ser- 
vice o servizi remoti per i 
client Macromedia Flash 
che utilizzano il servizio 
integrato Macromedia Fla- 
sh Remoting. 



GetWeatherO, che ci dà il report sullo stato meteo del- 
la città specificata e risponde in questo modo: 

<?xml version="1.0" encoding = "utf-16"?> 



NetServices.setDefaultGatewayUrl( 

"http://localhost:85QQ/flashservices/gateway"); 
this.gateway_conn = 

NetServices.createGatewayConnectionQ; 
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Distribuire su 
.NET o su J2EE 

Flash Remoting MX 
per Microsoft .NET è 
una implementazione pu- 
ra di .NET eseguita come 
codice gestito al 100%, 
che sfrutta i vantaggi of- 
ferti da .NET, garantendo 
prestazioni ottimali, fun- 
zionalità e sicurezza. 
Flash Remoting MX per 
Java è una soluzione Java 
pura al 100%, che può 
essere distribuita come 
file WAR o EAR su server 
applicativi Java conformi. 




mentre per informazioni di stato va usato nome- 
funzioneserver_status (stato). 
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Fig. 1: Come organizzare il movie. 

Notare che la sintassi del gateway è questa: 

http://[servername]/flashservices/gateway 

Sia chiaro che flashservicesj 'gateway non è un per- 
corso realmente esistente sul server, è solo una 
mappatura logica per il servizio Flash Remoting 
in ColdFusion MX. Avviene tutto in modo traspa- 
rente, senza configurare nulla, senza scrivere alcu- 
na riga di codice CFML! 

2) si crea un riferimento al servizio sul NetConnection 
(creo service object), es: 

this.myService = gateway_conn.getService( 

"http://www.webservicex.net 
/globalweather.asmx?WSDL", this); 

3) si invoca il servizio sull'oggetto service specifican- 
do l'oggetto di richiesta, es: 

this. myService.GetWeather({CityName: "Milano / 

Malpensa",CountryName:"Italy"}) 

Questa istruzione provvede a invocare il metodo re- 
moto implementato sul server e che ci espone il web 
service. Per ottenere la risposta abbiamo principal- 
mente due alternative: 

• settare un oggetto ricevente sulla getService, in 
questo caso nell'oggetto ricevente bisogna imple- 
mentare un metodo il cui nome è così composto: 

nomefunzioneserver_result(result) 



oppure 



se il ricevente non è settato nella getService, esso va 
settato sulla funzione chiamante come primo pa- 
rametro creando un new OggettoRiceventeO , ogget- 
to che al suo interno implementa i metodi onResult 
e onStatus, es: 

function OggettoRicevente () { 

this.onResult = function(result) { 

//dati ricevuti 



trace("Dati ricevuti : " + result); 



_L 



this.onStatus = function(error) { 



// controllo errore 



trace("Errore : " + error.description); 



> 



Neir esempio che stiamo costruendo invochiamo i 
metodi GetCitiesByCountry e GetWeather, andiamo 
quindi a definire due callback che si chiamano rispet- 
tivamente GetCitiesByCountry _result(result) e GetWea- 
ther _result(result). Entrambe vengono invocate in mo- 
do automatico quando arriva la risposta del server. 
Questi metodi ricevono un argomento che si chiama 
result che è un oggetto che contiene la risposta fornita 
dal web service. Nel nostro esempio riceviamo un og- 
getto xml, per usarlo da flash bastano poche righe di 
codice, per es: 

var cities_xml= new XMLQ; 

cities_xml.ignoreWhite=true; 

cities_xml.parseXML(result); 

In pratica istanziamo un nuovo oggetto, forziamo che 
i nodi di testo che contengono solo spazi bianchi ven- 
gano eliminati durante il processo di analisi sintattica 
(ignoreWhite=true) ed eseguiamo l'analisi del testo 
XML ricevuto, inserendo gli elementi dell'albero nel- 
l'oggetto (parseXML). 

Tramite il DOM (document object model) possiamo 
estrapolare le informazioni che ci servono andando a 
scorrere i nodi child. Quando riceviamo la lista di città 
popoliamo la combo, quando riceviamo il report me- 
teo organizziamo i dati in un hash secondo questo ge- 
nerico schema: 

hash [nodes[i].nodel\lame]= nodes[i].firstChild; 

Se avete bisogno di fare debug basta che all'interno di 
Flash Mx scegliate Window /NetConnection Debugger. 
Esso è un validissimo quanto utile strumento che per- 
mette di vedere cosa stia accadendo dietro le quinte. 
Vengono visualizzati i dati ricevuti insieme a una spe- 
cie di log delle chiamate. 
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Se qualcosa non va verrete avvisati subito. Un errore 
banale ma tipico consiste nel chiamare i metodi remo- 
ti passando parametri con tipo diverso. Per esempio 
se dovete passare una stringa al metodo remoto ac- 
certatevi che sia effettivamente una stringa antepo- 
nendo ""+ variabile oppure facendo new String (varia- 
bile). 

L'errore è banale e tipico perché Flash non è rigoroso 
sui tipi di dato, mentre il metodo remoto scritto sul 
server per es. in java o .NET sì. In Fig. 2 potete vedere 
un esempio del debugger. 



: : 




httFl3|Debugld:0 






l'fileiMJfflashjAiebseruices/weather.swr 

: "http" 

"<?xml version- 1 1.0" encoding- , utf-16 ,l ?> 
<CurrentWeather> 

<Location>Trieste, Italy (LIVT) 45-39N 013-45E 20M</Location> 
<Time>Jun 20, 2003 - 02:55 AM EDT / 2003.06.20 0655 UTC<ffime> 
<Wlnd> Calm:0<.Wind> 
<Visibility> greater than 7 mile(s):0<JVìsibility> 
<Temperature> 75 F (24 C)<iTemperature> 
<DewPoint> 66 F (19 C)<JDewPoint> 
<RelatweHumidity> 73%<iRelativeHumidity> 
<Pressure> 30.03 in. Hg (1017 hPa)</Pressure> 
<Status>Success<«tatus> 



J Operator [= J Value \_ 



Applv I Remove 



httpheaders 
E recordset 



Fig. 2: NetConnection Debugger in azione. 

Costruiamoci ora un oggetto con le informazioni che 
ci servono attingendo dall'hash i valori: 

var reportData= 

{ 

// costruisco oggetto con i dati di report 

Location :hash. Location, 

Wind: hash.Wind, 

Visibility: hash.Visibility, 

Sky: hash.SkyConditions, 

Temperature :hash .Temperature, 

Pressure: hash. Pressure 
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Esso ci tornerà utile per rappresentare in modo age- 
vole i dati raccolti. Per visualizzare il report, ci creia- 
mo infatti un componente Flash. Aprite la libreria 
(CTRL-L) e aggiungete un nuovo simbolo, chiaman- 
dolo "report" assegnando come itentifier di linkage 
sempre "report" come in Fig. 3. 
Editiamo il componente e inseriamo dei campi di te- 
sto con opportuni nomi di istanza che andremo a va- 
lorizzare tramite actionscript così: 

this.nome_istanza.text= 

this.informazione_da_rappresentare; 

Vi chiederete da dove salterà fuori " informazione _da_ 
rappresentare" , e qui viene il bello, e viene gratis. Infat- 
ti " informazione _da_rappresentar e" non è altro che una 
generica proprietà dell'oggetto reportData che abbia- 
mo creato, e che viene passato al componente in fase 
di creazione tramite questa istruzione: 

this.attachMovie ("report", "report_mc", 10, reportData) 

Questa istruzione permette di prendere da codice un 
elemento dalla libreria e di metterlo nello stage. Deve 
avere specificato l'itentifier di linkage, un nome di 
istanza e un livello su cui posizionarsi. Il quarto para- 
metro è il nostro oggetto personale costruito in prece- 
denza.Se avete fatto tutto bene dovreste visualizzare 
una scheda come quella in Fig. 4. 




Sky= mostly cloudy 

Wind: Cairn :0 

Visib: greater than 7 mile(s):0 

Temp: 66 F (14 C) 

Press: 30.12 in. Hg (1020 hPa) 



Fig. 3: Come settare il linkage al componente. 



Fig. 4: Fotoapp.bmp, didascalia=esempio di 
applicazione. 



Se avete dubbi o qualcosa non vi è riuscita, allegato al- 
la rivista c'è il movie d'esempio. 



CONCLUSIONI 

Abbiamo costruito lo scheletro minimo che permette 
di invocare un Web Service da Flash MX e senza scri- 
vere nessuna riga di codice sul server! 
A voi non resta che migliorare e approfondire questa 
struttura base inserendo meccanismi di caching e con- 
trolli sulla correttezza ed esistenza dei dati ricevuti. 
Tenete presente che sarà molto semplice creare un 
Web Service personale, qualora non disponiate di un 
servizio gratuito già pronto; ciò sarà oggetto di altri 
articoli. 

Marco Casario 




Flash 



Previsioni 

meteo animate 



Distribuire 
su qualsiasi 
periferica 

/^t Flash Remoting per- 
----J mette di distribuiee 
in modo uniforme, ad ol- 
tre 455 milioni di utenti 
Internet, attraverso le 
principali piattaforme e 
periferiche. Macromedia 
Flash Player è l'applica- 
zione rich-client più af- 
fermata, installata su ol- 
tre il 98% di tutte le pe- 
riferiche abilitate ad In- 
ternet. La distribuzione 
di applicazioni Internet 
dinamiche create con 
Macromedia Flash MX e 
Flash Remoting MX non 
richiede la distribuzione 
di software client addi- 
zionale. 



Applicazioni 
ben concepite 

/^t Con Flash Remoting, 
^J è possibile creare 
applicazioni Internet di- 
namiche ben concepite 
per implementare un mo- 
dello a tre livelli oppure a 
n livelli, con una netta se- 
parazione tra logica di 
presentazione e logica 
aziendale e dati. 
Inoltre, utilizzando le 
funzioni interne del ser- 
ver applicativo, quali la 
sicurezza e la gestione 
delle sessioni, Flash Re- 
moting MX garantisce 
l'integrazione dei mecca- 
nismi di sicurezza e di 
gestione delle sessioni 
tra i client Macromedia 
Flash ed i server applica- 
tivi. 
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sf Gli strumenti degli hacker. 



^ 8a ^ aaBMa ? 



Sicurezza 



File sul CD °® 

\soft\codice\CodiceBO.zip 



File sul Web EX 

www.ioprogrammo.net/ 
files/72/CodiceBO.zip 



Java è più sicuro 

y-a È importante notare 
^J che C/C++ è il lin- 
guaggio più vulnerabile 
agli errori di overflow a 
causa delle sue potenzia- 
lità; esso infatti consente 
di accedere e referenziare 
la memoria in maniera di- 
retta. Java evita questa 
classe di vulnerabilità 
perché ha una gestione 
molto sofisticata della 
memoria, ricorrendo all'u- 
so di algoritmi di de-allo- 
cazione e a sistemi come 
il Garbage Collector. 



Buffer OverFlow: Tarma 
segreta degli hacker 



"Esiste un sottile confine fra 

l'esser d'aiuto agli 

amministratori per proteggere i 

loro sistemi ed il fornire 

strumenti utili agli hackers. " 

[R. Morris, "UNIX Operating 

System Security"] 



Tre novembre 1988, una data che per molti non 
significa nulla, ma che per una ristretta cerchia 
di persone ricorda invece uno dei giorni più ne- 
ri della storia dei computer, quando una delle prime 
versioni della rete Internet, veniva bloccata e conge- 
stionata da un'entità anomala a cui sarebbe stato dato 
il nome di "worm" . I più preparati in materia ricorde- 
ranno senz'altro questa triste vicenda, causata quasi 
per scherzo da uno studente di nome R. Morris e dal 
suo codice malevolo, scritto in C, capace di infettare a 
catena le workstation con sistemi SunOS e BSD Unix, 
ospitate dal MIT e da Berkeley. Parte del codice infet- 
tivo di questo worm si basava su un tipo di attacco 
nuovo nel suo genere, che interessava il servizio fin- 
ger di Unix e che implementava il primo esempio di 
buffer overflow conosciuto della storia. Anno 2003, 
circa sette anni più tardi. La rete Internet è cresciuta a 




Fig. 1: Internet Health è un indice di misurazione 
dello stato di Internet a livello mondiale. 



dismisura e ricorda lontanamente il suo predecessore; 
il World- Wide- Web è diffuso ovunque e costantemen- 
te vengono creati nuovi servizi di rete, mentre le tec- 
nologie di routing e di trasmissione hanno fatto passi 
da gigante; i sistemi operativi e i linguaggi si sono 
evoluti notevolmente... ma, strano a dirsi, tutto ciò 
non basta per fermare l'avanzata del worm SQL-Slap- 
per, che il 25 Gennaio 2003, proprio come avveniva al- 
cuni anni prima, riusciva a paralizzare la rete mon- 
diale per diverse ore. Anche questa volta il problema, 
legato questa volta ad un prodotto Microsoft, dipende 
da un buffer overflow. 



GLI OVERFLOW 

Come si è capito da questo breve preambolo, il "Buf- 
fer Overflow" è diventato, col tempo, una delle forme 
di aggressione più diffuse e potenzialmente dannose 
contro i sistemi informatici. Nato originariamente in 
ambiente Unix, proprio perché tale sistema era conce- 
pito interamente in linguaggio C, oggi il buffer over- 
flow è un problema che interessa, senza esclusioni di 
sorta, sistemi operativi di ogni tipo (Unix, Linux, 
Win32, SunOS) e diverse architetture di calcolo (Intel, 
Alpha e MIP). Per rendersi conto della gravità del pro- 
blema e dell'estensione del fenomeno basta dare 
un'occhiata alla mailing list Bugtraq (http://www.secu- 
rityfocus.com/archive) o alla top-20 dell'istituto SANS 
(http://www.sans.org/top20/), che pubblicano ogni gior- 
no le vulnerabilità più diffuse su Internet: quasi tutte 
sono dovute ad errori di buffer overflow. In apparen- 
za, quando si verifica una condizione di overflow al- 
l'interno di un programma, a prima vista il program- 
matore sembra avere a che fare con un errore di poco 
conto, che nel peggiore dei casi può causare la termi- 
nazione imprevista di un'applicazione, lasciando un 
noioso messaggio di "crash" del programma. Tuttavia 
la condizione di overflow, come si è scoperto nel cor- 
so degli anni, è un problema ben più grave perché, se 
sfruttata pienamente, e in modo efficace da un hacker, 
può consentire ad un aggressore di iniettare e far ese- 
guire, anche da remoto, qualsiasi tipo di codice "mali- 
zioso" sul sistema vittima, compromettendone la si- 
curezza. Oggi si parla spesso di attacchi che sfruttano 
la condizione di buffer overflow, ma sono veramente 
poche le persone che capiscono a fondo e conoscono i 
meccanismi di queste vulnerabilità; altri invece hanno 
solo una vaga idea di cosa siano, mentre altri ancora 
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ritengono queste forme di attacco una specie di ''se- 
greto mistico" in mano ai guru e agli hacker della pro- 
grammazione. Al contrario non si tratta di nulla di co- 
sì eccezionale e misterioso come sembra, il buffer 
overflow - come vedremo a breve - è soltanto un pro- 
blema legato alla cattiva scrittura del codice da parte 
dei programmatori e alla mancanza di adeguati con- 
trolli nei sorgenti, nuir altro. In questo articolo, oggi, 
cercheremo di mostrare i principi che stanno alla base 
degli overflow, illustrando anche alcuni concetti (co- 
me lo stack e le function calls) che ci aiuteranno a capi- 
re meglio il codice presentato e serviranno per speri- 
mentare da vicino qualche overflow elementare. Le 
conoscenze richieste per una corretta lettura e per la 
piena comprensione degli argomenti trattati sono le 
basi del linguaggio C/C++ e i rudimenti di Assembly, 
con particolare riguardo per il funzionamento dei re- 
gistri, dello stack, delle chiamate e del controllo di ese- 
cuzione air interno di un programma. Nel presente ar- 
ticolo ci limiteremo a trattare una categoria molto co- 
mune di buffer overflow, che va col come di "stack-ba- 
sed overflow"; è comunque utile ricordare che oggi esi- 
ste una varietà di overfllow {heap overflow, frame poin- 
ter, adjacent memory, ecc.) più o meno complessi da im- 
plementare, la cui trattazione esula da queste pagine. 
Tutti i sorgenti considerati sono concepiti per lavorare 
sotto Win32, ma con poche modifiche sono facilmen- 
te portabili anche sotto Linux. 

LO STACK: IL CUORE 
DEL PROBLEMA 

Dovendo dare una definizione più formale del pro- 
blema descritto, potremmo dire che l' overflow è quel 
tipo di errore che occorre in un programma, al tempo 
di esecuzione, quando una certa istruzione tenta di 
scrivere dentro ad un buffer più informazioni di 
quante esso possa contenerne. Un buffer può essere 
visto come una sorta di contenitore di dati, anche se a 
livello fisico si tratta semplicemente di una preserva- 
zione di una certa zona della memoria {allocazione) 
mediante Y assegnazione di un indirizzo {offset) di par- 
tenza e di fine, che segnalano ad un programma dove 
risiede l'area di memoria dedicata al contenimento di 
determinate informazioni. U overflow avviene quan- 
do i dati scritti nel buffer oltrepassano i limiti presta- 
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Fig. 2: Schema logico di come è mappato un file 
eseguibile al momento del runtime. 



biliti, andando a modificare altre variabili adiacenti in 
memoria o (nella peggiore delle ipotesi) andando ad 
alterare il codice che è in fase di esecuzione, cosa a cui 
aspirano tutti gli hacker. Come si vedrà a breve, il pe- 
ricolo maggiore dell' overflow sta proprio nella possi- 
bilità di prendere il controllo di un programma, al 
tempo di runtime, modificando il flusso normale del- 
le istruzioni e dirottandolo {hijack) su altre istruzioni 
inserite dall'esterno nella memoria. Come si evince 
dalla Fig. 2, un programma in fase di runtime è map- 
pato in memoria attraverso alcune strutture logiche. Il 
segmento codice viene generalmente caricato in testa 
alla memoria e contiene le istruzioni, in linguaggio 
macchina, da eseguire sulla CPU; segue quindi l'area 
dati, di dimensione predefinita, che contiene le varia- 
bili "statiche" del programma (vettori di dimensione 
fissata, stringhe di testo, interi). La parte restante di 
memoria viene invece gestita dinamicamente al mo- 
mento dell'esecuzione e si divide (solo a livello logico, 
perché non esiste in realtà una divisione netta) in Heap 
e Stack; lo stack è quell'area che si trova sul fondo del- 
la memoria e che viene utilizzata durante le chiamate 
alle funzioni per salvare lo stato corrente dell'esecu- 
zione e per passare i parametri per argomento; l'heap 
è invece in cima ed è usato per gestire variabili dina- 
miche e puntatori (ad esempio quando in C++ si ri- 
chiama l'operatore new o l'istruzione malloc). 



GESTIONE DELLO STACK 

Lo stack viene gestito con politica LIFO (Last In, First 
Out) e mediante due istruzioni fondamentali del lin- 
guaggio Assembly: PUSH e POP. La prima memoriz- 
za un dato, la seconda lo estrae seguendo il modello 
LIFO, l'ultimo ad entrare è il primo ad uscire. La me- 
morizzazione dei dati nello stack segue un ordine in- 
verso, cioè parte dal fondo e man mano che le infor- 
mazioni vengono memorizzate, sale verso la cima. 
La gestione dello stack è affidata a due registri a 32-bit 
molto importanti, chiamati EBP e ESP {base pointer e 
stack pointer), usati - rispettivamente - per delimitare 
la cima e il fondo dello stack; quando si esegue una 
PUSH, il registro ESP viene decrementato di un nu- 
mero di byte pari alla dimensione del dato memoriz- 
zato, quando si esegue una POP il registro ESP viene 
invece incrementato. Le variazioni di ESP e EBP pos- 
sono inoltre essere fatte anche direttamente, tramite 
operazioni di somma e sottrazione {ADD e SUB): ad 
esempio l'istruzione SUB ESP,5 riserva cinque byte 
nello stack. Questo tipo di struttura si rivela efficiente 
e utile nella gestione delle chiamate di funzioni e pro- 
cedure in un programma, costituendo quello che è il 
meccanismo della "cali chain": una funzione può in- 
fatti richiamare un'altra funzione che a sua volta può 
chiamarne un'altra ancora e così via. Il sistema opera- 
tivo deve poter tenere traccia di tutte le chiamate in- 
nestate fra loro ed essere in grado tornare a punti pre- 
stabiliti del programma ove richiesto. Ogni chiamata 
ad una funzione viene tradotta in una istruzione di ti- 
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WebDAV... 
un altro caso 
di overflow 

Il recente bug della 
libreria di sistema 
NTDLL.DLL di Windows 
2000 (Server e Profes- 
sional) che ha causato 
tante polemiche su US e 
WebDAV, è un altro caso 
di buffer overflow. Per 
maggiori dettagli dare 
un'occhiata a ioProgram- 
mo n.69 del mese di Mag- 
gio. 
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Shellcode 

/-& Uno shellcode è un 
-J particolare codice As- 
sembly in grado di aprire 
una shell (per intenderci un 
"cmd /e") sul sistema ope- 
rativo. Per fare ciò, nei si- 
stemi Windows, si deve in- 
dividuare prima l'indirizzo 
di una particolare API di si- 
stema, la WinExec o in al- 
ternativa la CreateProcess. 
Per localizzare tali indirizzi, 
si deve conoscere il kernel 
base address del sistema 
operativo Windows in uso, 
indirizzo che varia da siste- 
ma in sistema e che rende 
molti exploit, di fatto, non 
trasportabili su tutti i siste- 
mi Microsoft: 



WINDOWS 


KERNEL BASE 


PLATFORM 


ADDRESS 


Win95 


0xBFF70000 


Win98 


0xBFF70000 


WinME 


0xBFF60000 


WinlMT 


0x77F00000 


(Service Pack 




4 and 5) 




Win2000 


0x77F00000 



Un rimedio che permette di 
conoscere gli indirizzi del 
sistema è quello di localiz- 
zare la chiamata GetProc- 
Address, che consente di 
risalire a qualsiasi altra API 
del sistema. 



pò CALL, che ha l'effetto di congelare l'esecuzione del 
codice fino a quel punto, passando poi il controllo al- 
la funzione chiamata, dopo aver salvato lo stato cor- 
rente e l'indirizzo di ritorno {return address), che ser- 
virà per riportare l'esecuzione nel punto in cui si era 
interrotta (il registro EIP è quello che punta sempre al- 
l'istruzione corrente). Da questo meccanismo si evin- 
ce una prima considerazione importante: poiché l'in- 
dirizzo di ritorno viene salvato nello stack, una even- 
tuale corruzione di tale area dati impedirà ad un qual- 
siasi programma di ritornare in uno stato consistente, 
con conseguente crash dell'esecuzione. 

LO STACK IN PRATICA 

Per capire meglio il funzionamento dello stack servia- 
moci di un esempio banale, considerando un pro- 
gramma C++ nel cui maini) è presente una generica 
funzione fi), a cui vengono passati due parametri. Per 
osservare l'uso dello stack, inseriamo nella funzione 
un buffer di 10 byte che non verrà effettivamente uti- 
lizzato nel sorgente. 

//listato Ll.CPP 

int f(int a, int b) { 

char buf[10]; 

int ris; 

ris=a+b; 

return ris; } 

void main() {f(3, 2);} 

Per vedere cosa avviene nello stack da vicino, basta 
compilare con Visual Studio (usando il comando CL 
Ll.CPP) il file Ll.CPP e successivamente aprire, usan- 
do lo stesso Visual Studio, l'eseguibile LI. EXE genera- 
to, avendo l'accortezza di specificare come tipo di file 
l'estensione .EXE. In questa modalità il Visual C++ di 
Microsoft si comporta come un vero debugger e con- 
sente di navigare nelle istruzioni Assembli/ corrispon- 
denti al codice C++ scritto: per avviare l'esecuzione 
step-by-step bisogna premere FU e scegliere dalla fi- 
nestra View I Debug Windows l'opzione Disassembly. Il 
codice macchina che si ottiene compilando questo 
programma apparirà grosso modo come quello che 
segue, commentato in questa sede solo per comple- 
tezza: 



file Edit émi Inserì: Proiect Build [pois DriverStudio Window Help 
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fi L1.exe 


Debugge lection... 


ÌUgo F5 




mSn^^Hffl 




• ExecuteLl.exe Ctrl+FS 


"1 } Run to Cursor Ctrl+FlO 
Attach to Process... 




- 
Configurations... 
Profile... 







// chiamata alla funzione f() nel main 




00401078push 


2 //passaggio del parametro 2 


0040107Apush 


3 //passaggio del parametro 3 


0040107C cali 


@>ILT+0(f) (00401005) //chiamata di f() 




//funzione f() 


00401020push 


ebp //salva il valore di EBP 


00401021 mov 


ebp,esp //allinea ebp 


00401023sub 


esp,50h 


00401026push 


ebx //salva lo stato dei registri 


00401027push 


esi 


00401028push 


edi 




00401038mov 


eax,dword ptr [ebp+8] 

//carica il primo numero 


0040103Badd 


eax,dword ptr [ebp+OCh] 

//esegue la somma del secondo 


0040103Emov 


dword ptr [ebp-10h],eax 


00401041mov 


eax,dword ptr [ebp-lOh] 

//memorizza il risultato in EAX 


00401044 pop 


edi //ripristina i registri salvati 


00401045pop 


esi 


00401046pop 


ebx 


00401047mov 


esp, ebp //ripristina lo stack 


00401049pop 


ebp 


0040104Aret 


//ritorna al chiamante 
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Fig. 4: Corrispondenza fra chiamata ad una 
generica funzione f() e il relativo codice Assembly 
(visto nel debugger). 

Al momento della chiamata di fi), si vedono chiara- 
mente le due istruzioni PUSH che memorizzano i va- 
lori "2" e "3" nello stack, mentre la CALL che invoca 
la funzione, ha come effetto quello di salvare nello 
stack l'offset corrente (registro EIP) e saltare air indiriz- 
zo di fi). Una istantanea dello stack subito dopo la 
chiamata ad fi) rivelerà questa situazione: 

STACK 



Fig. 3: Visual Studio integra un strumento di 
debugging avanzato, che può essere usato per 
aprire ed analizzare passo dopo passo i file 
eseguibili (EXE). 



401 07C (return address) 



EBP 
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IL PRIMO OVERFLOW 

Una volta capito questo meccanismo, siamo pronti a 
passare all'analisi di un vero overflow dello stack. 
Consideriamo il seguente listato, L2.CPP : 

//listato L2.CPP 

#include <stdio.h> 

void main(int argc, char **argv) { 

char buf[20]; 

FILE* f=NULL; 

int i = Q; 

printf("\nTest"); 

f=fopen("input.txt","rb"); 

while(!feof(f)) {buf[i]=fgetc(f); i+ + ;> 

//per sperimentare l'overflow basta creare un 

//file "input.txt" con la seguente stringa di (20 + 8 bytes) 
//AAAABBBBCCCCDDDDEEEEFFFFGGGG 



,X 
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Fig. 5: Crash da overflow. 

Si tratta di un esempio tipico di buffer overflow, do- 
vuto all'uso incauto di un buffer nella lettura da file. Il 
codice non fa altro che leggere un carattere alla volta 
dal file "input.txt" fino alla fine per copiarlo dentro la 
variabile buf. Naturalmente, poiché non c'è alcun con- 
trollo sulla dimensione del file, basta superare il limi- 
te del buffer (20 byte) per provocare la condizione di 
overflow. Nell'esempio vengono aggiunti di proposi- 
to 8 byte nel file "input.txt" , proprio per causare un 
overflow dello stack; cliccando su Debug dopo il cra- 
sh, si potranno notare alcune cose molto interessanti: 

• l'esecuzione raggiunge una zona "indefinita", in 
cui non ci sono istruzioni valide (segnalate da 
"???"); 

• il valore di EIP è 0x47474747 (che corrisponde in 
hex alla stringa "GGGG"); 

• il valore di EBP è 0x46464646 (che corrisponde in 
hex alla stringa "FFFF"). 

In definitiva, ci accorgiamo che i valori presenti nel- 
l'input sono andati a sovrascrivere parte dello stack, 
sovrapponendosi così ai dati salvati in esso, fra cui 
l'indirizzo di ritorno (return address) e il base pointer 
(EBP). 

CONTROLLARE IL FLUSSO 
DELL'ESECUZIONE 

Modificare il registro EIP significa, in parole povere, 
riuscire a modificare l'esecuzione del programma, di- 



rigendolo in una qualsiasi zona a nostro piacere. Una 
volta chiarito questo punto, possiamo iniziare a pro- 
gettare un exploit, in grado di sfruttare l'overflow in- 
dividuato per prendere il controllo del programma. Si 
procede studiando l'esecuzione del programma fino 
alla condizione di overflow, passo dopo passo, grazie 
alle funzioni di debugging offerte da Visual Studio. 
Ogni hacker che si rispetti è, infatti, costretto a disas- 
semblare un eseguibile affetto dall' overflow prima di 
poter scrivere un exploit valido in grado di violarne la 
sicurezza. Osserviamo che la parte iniziale del codice 
Assembly non rappresenta il nostro programma ma si 
tratta di routine pre-impostate inserite dal compilato- 
re di Visual C++. Il main vero e proprio inizia con la 
chiamata CALI 401000 all'indirizzo 
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Fig. 6: Entrando in modo Debug dopo l'overflow, 
si può vedere come il registro EIP e il registro EBP 
hanno assunto i valori 0x46464646 e 
0x47474747, che corrispondono alle stringhe di 
testo "FFFF" e "GGGG", passate in input. 



EIP=401000 



ESP=12FF84 



EBP=12FFC0 



00401000 push ebp //salva EBP nello stack 



00401001 mov 



ebp,esp 



00401003 sub esp,lCh 



//riserva spazio per "buf" 



00401006 mov dword ptr [ebp-18h],0 //variabile "FILE* f" 
0040100D mov dword ptr [ebp-lCh],0 //variabile "int i" 



EIP=401014 



ESP=12FF64 



EBP=12FF80 



Questa parte iniziale di codice viene generata dal 
compilatore e si "preoccupa" di riservare spazio nello 
stack utile per allocare buf (OxlC byte) e le altre varia- 
bili. Sono riportati i valori dei registri dello stack ESP 
e EBP prima e dopo l'esecuzione delle istruzioni. Suc- 
cessivamente il programma esegue la stampa a video 
con printfOl della stringa "Test". In linguaggio Assem- 
bly i parametri di una funzione vengono passati me- 
diante salvataggio nello stack: prima della chiamata a 
printfO troviamo infatti un'istruzione PUSH che me- 
morizza nello stack l'offset della stringa di testo. 



00401014 push 


407030h 


//offset string "\nTest" 


00401019 cali 


00401114 


//printfQ 


0040101Eadd 


esp,4 







Analizziamo adesso il ciclo di while che legge fino alla 
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Login? 
...no grazie! 

r& Quanto mostrato in 
-J questo articolo può 
essere ovviamente visto 
nell'ottica della sicurez- 
za su Internet; i servizi e 
i demoni dei server altro 
non sono che programmi 
scritti in C++. Nel corso 
della storia è capitato di- 
verse volte che un telnet 
o un server Web/FTP sia 
risultato vulnerabile ad 
un buffer overflow, a 
causa di un username di 
lunghezza esagerata. 
Sfruttando questa forma 
di aggressione un hacker 
può entrare in un siste- 
ma ed eseguire comandi 
senza bisogno neanche 
di autenticarsi e di cono- 
scere una password! 



h tt p :// www. iop rogrammo.net 



2 



3 ►►► 41 



C A 




fine del file i byte memorizzandoli nella variabile buf : 



Sicurezza 



Buffer 

OverFlow: l'arma 
segreta degli hacker 



Tipi di overflow 

r>& Oggi esiste una gran- 
--J de varietà di overfl- 
low nei programmi; sicu- 
ramente il più conosciuto 
e facile da manipolare per 
gli hacker è l'overflow del- 
lo stack, che permette di 
modificare in maniera effi- 
cace i valori dei registri 
EBP, ESP e EIP. Altri over- 
flow, meno rinomati e più 
difficili da gestire, sono 
l'Heap Overflow, il Frame 
Pointer Exception e l'Adja- 
cent Memory Overflow. 



Bibliografia PP 

Per chi fosse interessato 
all'intera storia del worm 
creato da Morris jr. nel 
1988, consigliamo la let- 
tura del seguente articolo: 

• UNIX OPERATINE SY- 
STEM SECURITY 
F.T. Grampp e R. Morris 
(AT&T Bell Lab. Technical 
Journal) Voi. 63, N. 8 
Ottobre 1984 

Anche il sito 

http : //world . std . com/~f ran 1/ 
worm.html 

offre spunti interessanti 
sui dettagli della vicenda, 
illustrando in maniera 
dettagliata il funziona- 
mento del worm. 



00401033 mov 


dword ptr [ebp-18h],eax 


00401036 mov 


eax,dword ptr [ebp-18h] 


00401039 mov 


ecx, dword ptr [eax+OCh] 


0040103Cand 


ecx,10h 


0040103Ftest 


ecx, ecx //test di fine file (EOF) 


00401041 jne 


00401061 


00401043 mov 


edx, dword ptr [ebp-18h] 


00401046 push 


edx 


00401047 cali 


004010C7 //lettura da file fgetc() 


0040104C add 


esp,4 


0040104F mov 


ecx,dword ptr [ebp-ICh] 


00401052 mov 


byte ptr [ebp+ecx-14h],al 

//memorizza il byte in buf 


00401056 mov 


edx, dword ptr [ebp-ICh] 


00401059 add 


edx,l //i++ 


0040105C mov 


dword ptr [ebp-ICh], edx 


0040105Fjmp 


00401036 //ciclo 



0040106D 


mov 


esp,ebp 




0040106F 


pop 


ebp 


//ripristina EBP 


00401070 


ret 




//istruzione di rit. 



L'istruzione alla riga 401052 è quella che scrive nel 
buffer il dato letto da file mediante fgetcQ. L'indirizzo 
del buffer è dato da [EBP+ECX-14h]; il valore viene in- 
crementato ad ogni iterazione grazie al registro ECX. 
E tuttavia la parte finale del programma, quella che 
segue immediatamente air istruzione fcloseO, la più 
interessante: viene ripristinato il valore del registro 
EBP e per chiudere la procedura si esegue un'istru- 
zione di ritorno RET. Tale istruzione ha l'effetto di 
estrarre una word (32-bit) dallo stack e di memoriz- 
zarla in EIP, modificando l'indirizzo dell'istruzione 
corrente e spostando così il flusso di esecuzione del 
programma. È in questo momento che emergono i 
problemi dell' overflow e il programma raggiunge 
una condizione indefinita. Il ciclo di while infatti, non 
si accorge di scrivere nel buffer più dati di quelli pre- 
visti (28 contro 20) e di conseguenza inizia a scrivere 
sopra lo stack alterando i valori in esso memorizzati. 




Fig. 8: Incontri ravvicinati con lo stack durante 
l'overflow: si vede chiaramente il punto in cui 
l'input passato al programma trabocca e 
sovrascrive altre zone di memoria. 



00401061 


mov 


eax, dword ptr [ebp-18h] 


00401064 


push 


eax 


00401065 


cali 


00401071 //fclose() 


0040106A 


add 


esp,4 



Tutto ciò si traduce con un errore che scatta nel mo- 
mento in cui si eseguono le istruzioni POP eRET.i va- 
lori estratti dallo stack non sono più quelli corretti, ma 
sono diventati parte dei dati letti da input; infatti, nel 
momento in cui si verifica il crash, ci si accorge che i 
registri EBP e EIP contengono i valori "0x46464646" e 
"0x47474747" ' , che corrispondono proprio ai caratteri 
in eccedenza presenti nel file input.txt (rispettivamen- 
te le stringhe "FFFF" e "GGGG"). 



EXPLOIT! 

Come si realizza un exploit capace di sfruttare l'over- 
flow appena visto? Abbiamo mostrato come sia pos- 
sibile controllare l'andamento del programma fornen- 
do input in eccedenza, ma possiamo fare di più e 
spingerci oltre: se nell'input invece di fornire caratteri 
e stringhe di testo, memorizziamo istruzioni Assem- 
bly a nostro piacimento, possiamo iniettare il nostro 
codice direttamente nello stack del programma e 
quindi modificare l'andamento del flusso d'esecuzio- 
ne, dirottando il registro EIP nel punto in cui si trova 
il codice iniettato. L'unica difficoltà di questa fase è il 
calcolo degli indirizzi e degli offset di allineamento, 
che dovranno combaciare perfettamente per far sì che 
il programma ad un certo punto esegua le nostre 
istruzioni; analizzando la stringa di overflow ci si 
rende conto che il valore GGGG pilota il registro EIP. 



AAAA 


BBBB 


ecce 


DDDD 


EEEE 


FFFF 


GGGG 


4 


8 


12 


16 


20 


registro EBP 


registro EIP 



La struttura dell'exploit prevede, quindi, un input di 
questa forma: in testa possiamo sfruttare i primi 20 
byte del buffer per memorizzare il codice che voglia- 
mo far eseguire, aiutandoci con eventuali istruzioni 
NOP (istruzione Assembly ininfluente, di no-opera- 
tion) per allineare il codice esattamente alla dimensio- 
ne di 20 byte. Seguono due word da 32-bit che corri- 
spondono ai valori scritti dall' overflow nei registri 
EBP e EIP; infine, poiché per questo exploit si è pen- 
sato di visualizzare una stringa di testo, memorizze- 
remo nella parte finale dell'input una stringa di testo, 
terminata da 0. 



INJECTED CODE 


NOP (0x90) 


EBP 


EIP 


STRINGXO 


0... 


...20 


1 word 

(4 byte) 


1 word 

(4 byte) 


"EXPLOIT 
WORKS" 



Analizzando col debugger l'esecuzione del program- 
ma, si nota che il valore di EBP prima dell' overflow è 
0x0012FF80, mentre lo stack usato per memorizzare i 
dati inizia all'offset 0x0012FF6C, che sarà proprio il 
punto in cui partirà il codice iniettato. Conosciamo 
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quindi i valori delle word di EBP e di EIP, non resta 
che scrivere il codice da iniettare. Lo scopo di un 
hacker è quello di progettare uno shellcode, cioè un co- 
dice capace di aprire una shell remota in grado di ac- 
cettare comandi dall'esterno; la scrittura degli shellco- 
de è diventata ormai un'arte, a causa di numerose 
problematiche ad essa legate. Primo fra tutti c'è il pro- 
blema della differenza fra sistemi operativi (uno shel- 
lcode per Linux non funziona su Windows), anche 
quando si tratta della stessa famiglia (gli indirizzi ba- 
se del kernel di Windows variano a seconda della ver- 
sione). Altra difficoltà è rappresentata dalla codifica 
Unicode delle stringhe di testo (che altera il codice 
iniettato dall'hacker) e dai sistemi anti-intrusione IDS 
(che identificano gli shellcode come con i virus e co- 
stringono gli hacker a scrivere shellcode criptati). Nel 
nostro esempio non scriveremo uno shellcode, poiché 
l'utilizzo di tale tecnica richiederebbe un articolo a sé 
stante, per cui ci limiteremo a far eseguire una istru- 
zione printfO che visualizzi a stringa iniettata "EX- 
PLOIT WORKS". Cos'altro serve per scrivere il codi- 
ce? Naturalmente abbiamo bisogno dell'offset della 
stringa da visualizzare e dell'indirizzo di printfO, che 
- come abbiamo visto prima - è localizzata a 0x0040 
1114. Il codice Assembly da iniettare sarà così fatto, 
per un totale di 3 + 5 + 5 = 13 byte. 



90 


NOP 


90 


NOP 



OPCODES 


ISTRUZIONE 


83 EC 20 


SUB ESP, 0x20 


68 xl x2 x3 x4 


PUSH offset(stringa) 


E8 yl y2 y3 y4 


CALL printf 



Per raggiungere i 20 bytes richiesti dall' overflow, si 
aggiungono 7 istruzioni NOP alla fine del codice. Gli 
opcodes sono i codici esadecimali che corrispondono 
alle istruzioni Assembly; ad esempio "83 EC" identi- 
fica l'istruzione "SUB ESP", che seguita dal valore 
0x20, sottrae 20 bytes dal registro ESP. Non rimane 
che calcolare i valori "xl x2 x3 x4" e "yl y2 y3 y4" del- 
la PUSH e della CALL. L'offset della stringa di testo si 
calcola partendo dall'indirizzo iniziale del nostro buf- 
fer (dove inizia il codice, 0x001 2FF6C) a cui si aggiun- 
gono i 28 bytes del buffer, ottenendo 0x0012FF88. Per 
calcolare il valore di "yl yl y3 y4" occorre invece par- 
tire dall'indirizzo della funzione printfO 0x00401114 a 
cui bisogna sottrarre l'offset in cui si trova l'istruzione 
CALI, che è dato da 0x0012FF6C+3+5+5 = Ox 
0012FF79. Quindi otteniamo per "yl yl y3 y4" il valo- 
re di 0x002D119B. Riscrivendo il codice avremo ora: 



OPCODES 


ISTRUZIONE 


83 EC 20 


SUB ESP, 0x20 


68 88 FF 12 00 


PUSH 0x0012FF88 


E8 9B 11 2D 00 


CALL 0x002D119B 


90 


NOP 


90 


NOP 


90 


NOP 


90 


NOP 


90 


NOP 



Piccolo accorgimento: gli indirizzi e gli offset delle 
istruzioni Assembly vanno scritti al contrario, cioè 
leggendoli da destra verso sinistra. Per creare un file 
di input fatto in questa maniera, basta ricorrere a un 
semplice programma C++, che unisca i vari pezzi del- 
l'exploit, scrivendoli su un unico file "input.txt" sul 
CD Rom trovate il listato Gen.CPP. 
Usando come input il file generato da GEN.CPP per il 
programma del listato L2.CPP, si realizza l'exploit che 
prende il controllo del programma in fase di esecu- 
zione e visualizza la stringa "EXPLOIT WORKS" sul- 
lo schermo. Ovviamente al termine della printfO il 
programma si trova in uno stato non definito e va co- 
munque in crash, anche se tecnicamente era possibile 
portare a termine l'esecuzione senza visualizzare al- 
cun errore, dirottando il codice verso la chiamata ad 
exitO- 



CONCLUSIONI 

Prevenire è meglio che correre ai ripari. Ma come ci si 
può difendere dagli overflow? Esistono diverse solu- 
zioni proposte dagli esperti, alcune delle quali richie- 
derebbero la modifica dei kernel e dei principali com- 
pilatori. 
Alcune di queste sono: 

• Non Executable Stack - Modificando il kernel si 
può rendere il segmento che contiene i dati dello 
stack non-eseguibile, in modo che se accidental- 
mente o volutamente un programma dovesse fi- 
nire in questa zona di memoria, verrebbe genera- 
to un protection fault, terminando il processo. 

• Random Stack Address - Per poter pilotare il 
flusso di esecuzione, un exploit deve disporre di 
indirizzi affidabili e validi da assegnare ai registri 
EIP e ESP. Utilizzando uno stack con modalità di 
indirizzamento casuale, si potrebbe complicare 
ulteriormente la vita degli hacker nella realizza- 
zione di exploit di portata universale. 

• Bounds Checking - Il problema degli overflow 
nasce dalla mancanza di controlli da parte del 
programmatore e del compilatore. Piccoli accorgi- 
menti possono fare la differenza, come in questo 
caso: 



strcpy(buf, ptr); 



// insicuro!!! 



strncpy(buf, sizeof(buf), ptr); 



// sicuro 



Le funzioni standard del C++ vulnerabili agli over- 
flow sono comunque tante, tra cui le principali indi- 
viduate sono: strcopyO, strcatO, sprintfO, getsO, scanfO- 
Il controllo dei limiti può essere effettuato dal pro- 
grammatore, ma potrebbe essere gestito anche a livel- 
lo di librerie, usando funzioni safe. 

Ing. Elia Florio 
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Posta elettronica 

con VB 



Ó] 



RFC1425 

Il documento RFC1425 
descrive una nuova 
versione di SMTP denomi- 
nata ESMTP (Extended 
SMTP). Il client che deside- 
ra farne uso invia, all'inizio 
della comunicazione con il 
server, la stringa EH LO an- 
ziché HELO. 



sf In pratica: protocolli di comunicazione. 

Un mail client 
in Visual Basic 



Lo scopo di questa serie di 

articoli è arrivare a 

realizzare un completo client 

di posta elettronica. In 

questo primo appuntamento 

analizzeremo i protocolli di 

comunicazione. 



Tra i servizi offerti da Internet, quello che 
probabilmente risulta essere il più utiliz- 
zato, è quello della posta elettronica. In- 
ternet è ormai diventata una realtà da moltissi- 
mi anni e questo servizio per il recapito e la ri- 
cezione di mail elettroniche può essere conside- 
rato, senza ombra di dubbio, uno dei principali 
motivi si successo.Sappiamo tutti che un indi- 
rizzo di posta elettronica generico è una stringa 
molto simile alla seguente: username@host. domi- 
nio in cui username è la sottostringa che identifi- 
ca "genericamente" l'interlocutore al quale in- 
viare il messaggio di posta elettronica, mentre 
host . dominio rappresenta un nome DNS o un in- 
dirizzo IP presso il quale l'utente "possiede" 
una casella di posta elettronica. Ovviamente 
questa sintetica descrizione racchiude in sé mol- 
to più di una semplice stringa poiché, come ve- 
dremo, le componenti (software e non) che en- 
trano in gioco quando inviamo un messaggio di 
posta elettronica sono davvero tante. La gestio- 
ne della posta elettronica è implementata in In- 
ternet attraverso la cooperazione di due catego- 
rie di sottosistemi: 

• Mail User Agent (MUA); 

• Mail Transport Agent (MTA). 

Il MUA rappresenta il generico programma di 
gestione della posta (Outlook, Eudora, Pegasus 
Mail, ecc.) installato sul proprio client. Esso deve 
possedere alcune caratteristiche fondamentali: 

• Interfaccia utente per la gestione dei mes- 



saggi di posta elettronica, ossia deve consen- 
tire la composizione, la ricezione e la lettura 
dei messaggi. 

• Deve essere in grado di "colloquiare" con i 
mail server che provvedono all'invio dei 
propri messaggi all'MTA. 

• Riconoscere la sintassi di composizione dei 
messaggi (secondo le specifiche RFC822 e 
MIME) 

L'MTA possiamo vederlo invece come il canale 
di comunicazione tra due MUA. Il suo scopo 
principale è quello di consentire la ricezione di 
tutti i messaggi ed il loro recapito. L'MTA, se- 
condo quanto già intuito, può essere: 

• un server SMTP che si occupa della spedi- 
zione e della ricezione delle mail da e verso 
altri server SMTP; 

• un server POP3 che si occupa di spedire i 
messaggi ad ogni client; 

• un server IMAP4 che consente la gestione 
dei messaggi direttamente sul server. 

Naturalmente, ognuno di questi servizi è attivo 
su una porta TCP/IP diversa, ognuno di essi 
potrebbero risiedere su di uno stesso server o su 
server diversi, cosa che accade, solitamente, in 
realtà aziendali molto articolate. In questo arti- 
colo vedremo come implementare un semplice 
client di posta elettronica in grado di leggere ed 
inviare mail. Per poter comprendere il funzio- 
namento di questo programma (ed in generale, 
di ogni programma che implementa il colloquio 
con un server mediante un qualunque protocol- 
lo), è opportuno avere dimestichezza con i pro- 
tocolli di comunicazione che si dovranno utiliz- 
zare ed essere in grado d'implementare un ge- 
nerico dialogo mediante Telnet. Questo consen- 
te di provare "in loco" la corretta implementa- 
zione del colloquio client-server nel linguaggio 
(protocollo) specificato ed individuare con mag- 
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giore facilità i problemi ai quali si può incorrere 
in fase di programmazione. 



IL PROTOCOLLO SMTP 

Il protocollo SMTP costituisce il "linguaggio" 
standard per rinvio delle proprie mail. Un ge- 
nerico esempio di comunicazione in SMTP è 
mostrato in Fig. 1. 



Release 5.0.11) rea 



Telnet SMTPSRV 25 



220 SMTPSRV.MyDomain.it ESMTP Service (Lotus 

HELO 10.0.1.100 

250 SMTPSRV.MyDomain.it Hello 10.0.0.200 ([10.0.0.200]), pleased to meet you 

MAIL FROM: flippo@MyDomain.it 

250 flippo@MyDomaiii.it... S elider OK 

RCPT TO: flippo@libero.it 

250 flippo@libero.it... Recipient OK 

RCPT TO: flippo@emaU.it 

250 flippo@email.it... Recipient OK 

DATA 

354 Enter message, end with "." on a Une by itself 

FROM: Francesco Lippo (Ed Master) 

TO: flippo@libero.it 

CC: flippo@email.it 

SUBJECT: TEST ED. MASTER 

Prova invio mail per IoPro grammo 

250 Message accepted for delivery 



Connessione all'ho st perduta. 



Fig. 1: Un esempio di comunicazione in SMTP con 
un server di posta. 

I comandi principali di questo protocollo sono: 

• HELO: questo comando dà inizio al collo- 
quio con il server SMTP e serve ad identifi- 
care il client, mediante il parametro Hostna- 
me. Un generico comando è: HELO flippo. 

• MAIL FROM: con questo comando è inizia- 
lizzata la vera e propria transazione. In que- 
sto caso si deve indicare il mittente (reverse- 
path) a cui è riferita la creazione della mail. 
Un generico formato del comando è MAIL 
FROM: Francesco. Lippo@edmaster .it. Il server 
risponde con un reply number 250 del tipo 
Sender OK. Questo comando pulisce i buffer 
e inserisce nello stesso buffer dedicato al 
mittente, la mail del client. 

• RCPT TO: serve ad identificare i destinatari 
del messaggio. Un generico esempio è RCPT 
TO: Francesco.Lippo@edmaster.it . 

• RSET: consente di "resettare" le impostazio- 
ni correnti dell'email che si stava configu- 
rando per l'inoltro, permettendo di ricomin- 
ciare con un nuovo messaggio di posta elet- 
tronica. 



con un messaggio di esito positivo in cui si 
indica che il messaggio è stato accettato per 
Tinvio. 

• VRFY: consente di verificare l'email di un 
qualunque destinatario di posta elettronica. 
Un esempio è VRFY Francesco. Lippo@edma- 
ster.it. 

• HELP: mostra l'elenco dei comandi accettati 
dal server. 

• QUIT: chiude il colloquio tra client e server 
SMTP. 

Il documento RFC 1425 descrive una nuova ver- 
sione di SMTP denominata ESMTP (Extended 
SMTP). Il client che desidera farne uso invia, al- 
l'inizio della comunicazione con il server, la 
stringa EHLO anziché HELO. Se il server con cui 
si sta comunicando supporta ESMTP, la risposta 
inviata al client sarà un certo numero di righe 
con prefisso /codice 250. Questa risposta è di so- 
lito multilinea, poiché ognuna contiene una pa- 
rola chiave e, opzionalmente, un argomento che 
specifica le estensioni SMTP supportate dal ser- 
ver. In caso contrario, ossia qualora il server non 
riconoscesse il comando EHLO (vale a dire, 
quindi, le estensioni ad SMTP), invierà al client 
un codice di errore. Non ci soffermeremo a lun- 
go su questo protocollo, ma come già detto è 
consigliabile effettuare delle prove con un ser- 
ver presso il quale si possegga una casella di po- 
sta (anche locale), mediante Telnet sulla porta 
25, per "simulare" l'invio di un messaggio di 
posta tramite esso. 



IL PROTOCOLLO POP3 

Contrariamente a quanto si potrebbe pensare, il 
protocollo per la ricezione dei messaggi di posta 
elettronica è diverso da quello impiegato per 
l'invio. Il più utilizzato è senza dubbio il Post 
Office Protocol 3 (POP3), ma può essere sfruttato 
anche 1TMAP4. In realtà esistono più versioni 
di questo protocollo (il numero 3 accanto all'a- 
cronimo POP indica, per l'appunto, la terza ver- 
sione di questo protocollo), ma la versione 
POP3 è senza dubbio quella più sfruttata. L'im- 
plementazione del protocollo POP3 è relativa- 
mente più complessa di quella impiegata per 
SMTP. Una generica conversazione in POP3 
prevede essenzialmente tre fasi distinte: 




Posta elettronica 

con VB 



Un mail client 

in Visual Basic 



Protocolli 



ó: 



, Contrariamente a 
quanto si potrebbe 
pensare, il protocollo 
per la ricezione dei 
messaggi di posta elet- 
tronica è diverso da 
quello impiegato per 
rinvio. Il più utilizzato è 
senza dubbio il Post Of- 
fice Protocol 3 (POP3), 
ma può essere sfruttato 
anche TIMAP4. 



DATA: lanciato senza parametri, offre la 
possibilità d'inserire il testo della nostra mail 
che dev'essere necessariamente completato 
da questa sequenza: <CRLF>. <CRLF>. Se 
tutto è andato a buon fine, il server risponde 



Autenticazione: in questa fase, il client invia 
al server le proprie credenziali (username e 
password) per richiedere l'accesso alla pro- 
pria casella postale. Qualora la risposta del 
server sia positiva, quest'ultimo ne concede 
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Posta elettronica 

con VB 



Un mail client 

in Visual Basic 



Dowload 
messaggi 
di posta 



Ó 



Analogamente a 
quanto accadeva 
con SMTP, ogni utente 
che desidera scaricare 
i propri messaggi di 
posta elettronica, de- 
ve stabilire una con- 
nessione TCP sulla 
porta 110 del server 
POP3. 



TECNICA ► ► ► > 

l'accesso, bloccandone l'utilizzo da parte di 
altri programmi. 

• Transizione: durante questa fase, il client 
scarica effettivamente i messaggi dalla pro- 
pria casella postale. L'utente termina questa 
conversazione con il comando QUIT. 

• Aggiornamento: durante questa fase il ser- 
ver procede ad effettuare un aggiornamento 
delle informazioni, eliminando gli eventuali 
messaggi contrassegnati per V eliminazione 
nella Transaction Phase, sbloccando la casella 
postale ed infine chiudendo la connessione 
definitivamente . 

Analogamente a quanto accadeva con SMTP, 
ogni utente che desidera scaricare i propri mes- 
saggi di posta elettronica, deve stabilire una 
connessione TCP sulla porta 110 del server 



I Reply Number di un server 
SMTP 

Di seguito è mostrato un elenco dei cosiddetti 
Reply Number ossia i messaggi possibili che il 
server SMTP restituisce al client quando que- 
st'ultimo gli invia un qualunque comando. Ac- 
canto ad ognuno è mostrata una breve descri- 
zione sul loro significato: 

211 System status, o system help reply. 

214 Messaggio di Help. 

220 <domain> Servizio pronto. 

221 <domain> Servizio ha chiuso il canale. 

250 Azione completata, OK. 

251 Utente non locale; si spedirà a 
<forward-path>. 

252 Non è possibile verificare l'email, ma è 
comunque accettata. 

354 Inizia l'input dei dati; termina con 

<CRLF>.<CRLF>. 
421 Servizio non avviabile. 

450 Richiesta di azione non avviabile. 

451 Richiesta di azione abortita: errore 
locale durante il processo. 

452 Richiesta di azione abortita: spazio di 
sistema insufficiente. 

500 Errore di sintassi, comando non 
riconosciuto. 

501 Errore di sintassi nei parametri o negli 
argomenti. 

502 Comando non implementato. 

503 Cattiva sequenza del comando. 

504 Parametri del comando non 
implementati. 

550 Richiesta di azione non presa. 

551 Utente non locale; tentare con 
<forward-path>. 

552 Richiesta di azione abortita: si eccede 
l'allocazione di spazio. 

553 Richiesta di azione non presa: nome 
della mailbox non permesso. 

554 Transazione fallita. 



Telnet POP3SRV 110 

+OKPOP3 PROXY server ready (6.5.001) <371E4DCC077DEE7F726AAC5A1D8680473BBCBB 

USER fflppo 

+OK Password required 

PASS pippo 

+OK27messages 

RETR27 

+OK 1626 bytes 

Retimi Patii: nippo@MyDoiiiain.it 

Received: from smtp7.MyDomain.it (193.70.192.90) by ims2 e. MyDomain.it (7. 

id 3E933ED3000E47E8 for flippo@MyDomain.it; Fri, 11 Apr 2003 09:33:57 +0200 
Received: from it-hubm.MyD omain.it (212.141.56.- lyDomain.it (6.7.015) 

id 3E8DC05700CE9AD7 for fflppo@MyD omain.it; Fri, 11 Apr 2003 09:33:57 +0200 
Received: from POP3SRV.MyDomain.it ([138.70.193.142]) 
by it-hnbm.MyDomain.it (Lotus Domino Release 5.0.11) 
with ESMTP id 2003041109354487:73 ; 
Fri, 11 Apr 2003 09:35:44 +0200 
Received: from 138.70.192.180 ([138.70.192.180]) 

by POP3SRV.MyDomain.it (Lotus Domino Release 5.0.11) 
with SMTP id 2003041109325928:23 ; 
Fri, 11 Apr 2003 09:32:59 +0200 
FROM: Francesco Lippo Ed Master 
CC: fUppo@email.it 

X-MLMETrack: Itemize by SMTP Server on POP3SRV/IT/MyDomain(Release 5.0.11 |July 24, 20 
11/04/2003 09.34.28, 

Serialize by Ronter on POP3SRVTT MyDomaiii(Release 5.0.11 |July 24, 2002) at 
11/04/2003 09.34.29, 

Serialize complete at 11/04/2003 09.34.29, 

Itemize by SMTP Server on IT-HUBM/IT/MyDomain(Release 5.0.11 |July 24, 2002) at 
04/11/2003 09:35:44 AM, 

Serialize by Router on IT-HUBM/IT/MyDomain(Release 5.0.11 |July 24, 2002) at 
04/11/2003 09:35:46 AM, 

Serialize complete at 04/11/2003 09:35:46 AM 
To: Hippo@MyUbero.it, fUppo@emaU.it 
D-.ilo: Fh. 11 \pi 2003 09:34:28 0200 
Message-DD:<OF51E91996.06D52D06-ONC1256D05.00299BE5@MyDomain.it> 

SUBJECT: TEST ED. MASTER 

Prova invio mail per IoPro grammo 

LIST 
+OK 

1 1871 

2 20836 

3 24317 



DELE 27 
+OKmess 
LIST 
+OK 
1 1871 



ige marked for deletion 



Fig. 2: Un esempio di comunicazione in POP3 con 
un server di posta. 



POP3. Subito dopo aver stabilito la connessione, 
il server si "presenta" ed è pronto ad accettare i 
comandi ad esso inviati. Come abbiamo avuto 
modo di accennare, la prima fase prevede l'au- 
tenticazione dell'utente. Il protocollo POP3 pre- 
vede diversi modi con cui il client può identifi- 
carsi, ma quello più utilizzato consiste nell'uti- 
lizzo dei comandi USER e PASS. Attraverso il 
primo, il client invia al server il nome utente re- 
gistrato corrispondente ad una casella postale 
ben definita. Se il server accetta il nome allora è 
possibile spedire anche la password mediante il 
comando PASS, seguito dall'opportuna parola 
d'ordine associata al nome in questione. A que- 
sto punto, avvenuta l'autenticazione, il client ha 
finalmente accesso alla propria casella postale e 
può, quindi, effettuare operazioni su di essa. Ha 
inizio la seconda fase del collegamento (Transac- 
tion Phase). Durante lo scambio delle informa- 
zioni tra client e server, è possibile osservare 
due soli possibili indicatori di stato che, posti al- 
l'inizio di ogni riga, identificano immediata- 
mente la risposta del server, oltre ad un'azione 
richiesta dal client: +OK e -ERR. Una volta en- 
trati nella fase di transazione, il server assegna a 
ogni messaggio un identificativo numerico 
(partendo dal numero uno) mentre il client può 
iniziare, a sua volta, la spedizione delle proprie 
richieste utilizzando una serie di comandi a sua 
disposizione. Ecco i principali: 
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• RETR: questo comando, seguito dal numero 
di messaggio, consente di scaricare una ge- 
nerica mail e leggerla. 

• STAT: restituisce il numero di messaggi 
presenti nella propria casella postale e la di- 
mensione totale della stessa. 

• LIST: restituisce l'elenco delle mail contenu- 
te all'interno della casella postale, numerate 
in ordine progressivo e la dimensione di cia- 
scuna. 

• NOOP: restituisce semplicemente +OK. 
Questo semplice comando, poco utilizzato, 
può servirci a controllare lo "stato" del ser- 
ver per assicurarci che esso sia ancora rag- 
giungibile ed in ascolto. 

• DELE: contrassegna per la cancellazione un 
determinato messaggio. 

• RSET: reimposta il contrassegno che identi- 
fica, per ogni mail, la richiesta di eliminazio- 
ne dal server. 

In Fig. 2 è mostrato un generico colloquio in 
POP3 con il proprio server di posta. Per ragioni 
di spazio, la lista dei messaggi presenti all'inter- 
no della casella di posta usata per i test (al mo- 
mento delle prove risultava un totale di 27 mes- 
saggi), è stata "sintetizzata" mostrando sempli- 
cemente le prime e le ultime mail. Si osservi un 
particolare importante, ossia il fatto che la pas- 
sword relativa alla propria casella postale, digi- 
tata dopo PASS, è inviata "in chiaro". Quest'an- 
notazione può essere importante qualora si de- 
cida di realizzare un colloquio in Telnet con il 
proprio server di posta e non si desideri far co- 
noscere ad altri quest'informazione. Quindi, in 
definitiva, è bene essere certi che nessuno ci sia 
accanto quando la digitiamo per inviarla al no- 
stro server POP3. Prima di passare oltre, è bene 
tener presente alcuni comandi ai quali bisogne- 
rebbe prestare molta attenzione: RETR, DELE e 
RSET. Il primo, permette di ricevere un messag- 
gio e richiede come unico parametro il numero 
del messaggio stesso. L'output a video è molto 
simile a quanto mostrato in Fig. 2 e, a meno di 
non essere nel caso di operazioni particolari, l'u- 
nica parte importante è quella relativa al mit- 
tente ed al body dell'email. Il secondo comando, 
invece, permette di marcare un messaggio della 
casella postale affinché possa essere cancellato 
durante la fase di aggiornamento. Sottolineo 
"marcare" poiché, dopo quest'operazione, tutti 
i messaggi contrassegnati attraverso DELE non 
risultano ancora essere stati eliminati dal server, 
pur risultando nascosti ed apparentemente eli- 



minati. Sarebbe opportuno lanciare questo co- 
mando dopo ogni lettura, in maniera tale da li- 
berare spazio all'interno della propria casella 
postale. Comunque sia, qualora ci si accorga di 
aver lanciato erroneamente il comando DELE, 
basterà servirsi di RSET per "resettare" la lista 
delle mail da cancellare. 



IL FORMATO MIME 

In questo paragrafo parleremo brevemente di 
MIME al fine di avere un quadro più chiaro del- 
le problematiche che coinvolgono un servizio di 
posta elettronica. Inizialmente il protocollo per 
la rappresentazione dei documenti di posta elet- 
tronica era definito nel documento RFC 822. Es- 
so specificava il formato per i messaggi di posta, 
limitandosi a messaggi esclusivamente di tipo 
testo ASCII, senza alcun riferimento ad altri for- 
mati. 

Una delle principali limitazioni del protocollo 
descritto in RFC 822 risiede nel fatto che il con- 
tenuto dei messaggi è limitato ai soli caratteri 
codificati in 7 bit. Quest'imposizione obbliga, 
prima dell'invio, a convertire ogni messaggio 
che non contenga esclusivamente semplice testo 
ASCII. Per ovviare a questo inconveniente, nel 
1992 fu finalmente introdotto un nuovo docu- 
mento nel quale veniva descritto lo standard 
MIME (RFC 1341). In esso vengono presentati i 
meccanismi per superare le limitazioni contenu- 
te in RFC 822 ossia: 

• definizione del formato di messaggi testuali 
(ASCII e non) 

• definizione del formato di messaggi multi- 
mediali (contenenti video, suono, immagini, 
ecc.). 

Il MIME e, nello specifico, S/MIME, è stato deci- 
sivo per l'implementazione dei servizi di sicu- 
rezza che offrono all'utente la possibilità di in- 
viare messaggi corredati di firma digitale, di 
crittografia o di autenticazione. 
Qualunque linguaggio di programmazione si 
desideri utilizzare, per poter implementare cor- 
rettamente un client di posta, occorre conoscere 
necessariamente le specifiche appena menzio- 
nate. L'RFC 822 è costituito "semplicemente" da 
una stringa di testo formata da due parti distin- 
te: un header ed un body, separati da una linea 
vuota. L'header, che racchiude in sé le infor- 
mazioni per il trasporto della mail, può essere 
così schematizzato: 

• TO: indica la lista dei destinatari. 

• FROM: mittente dell'email. 
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Gli standard 
per la posta 
elettronica 

Gli standard ed i pro- 
tocolli fondamentali 
per il funzionamento del- 
la posta elettronica in 
ambiente Internet sono: 

• il formato dei messaggi 
di posta, descritto nel- 
l'RFC 822; 

• il formato MIME per la 
definizione del formato 
dei dati, descritto negli 
RFC 1341, 1342, 2045, 
2046, 2047 e 2048 e che 
estende il formato de- 
scritto nell'RFC822; 

• il protocollo SMTP, de- 
scritto nell'RFC 821; 

• il protocollo POP3, de- 
scritto nell'RFC 1939. 
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dal file binario 3 byte per 
volta e li converte in 4 
caratteri ASCII. 
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• CC: lista dei destinatari per conoscenza. 

• BCC: lista nascosta di destinatari per cono- 
scenza. 

• DATE: data dei spedizione dell'email. 



con VB 



REPLY-TO: indirizzo alternativo del mitten- 
te a cui inviare le risposte. 

SUBJECT: oggetto del messaggio. 



Con lo standard MIME è possibile inserire, in 
un qualsiasi messaggio e-mail, oltre al testo, an- 
che file contenenti immagini, segnali audio e vi- 
deo. In particolare, è bene ricordare che il soft- 
ware che dovrà gestire la posta non deve preoc- 
cuparsi del contenuto del messaggio, poiché è 
l'utilizzatore finale a dover applicare l'opportu- 
na decodifica in base alle "specifiche di tipo" in- 
serite nel messaggio stesso. Un documento MI- 
ME contiene una testata in cui si trovano i se- 
guenti campi: 

• MIME version: identifica la versione dello 
standard MIME usato nella mail. 

• Content- Transfer-Encoding: specifica un 
modo di codifica dei dati accessorio a quello 
principale. I possibili valori che può assume- 
re questo attributo sono 7bit, 8bit, binary, quo- 
ted-printable e base64. 

• Content-Type: consente di specificare il tipo 
ed il sottotipo di dati contenuti all'interno 
del messaggio (MIME type). Attraverso esso, 
il client che riceve la mail è in grado di rile- 
vare in che maniera sono stati codificati i da- 
ti ricevuti. Questo attributo, insieme a quel- 
lo precedente, identificano la parte fonda- 
mentale di questo standard e, nel contempo, 
l'aspetto più complesso da gestire. 



que consente di aggiungere degli allegati al no- 
stro messaggio, permettendoci anche di salvarli 
una volta ricevuta la mail. Gli allegati possono 
essere costituiti da file di qualsiasi genere. Ciò, 
ovviamente, significa anche che non è possibile 
inserirlo "immediatamente" all'interno del no- 
stro messaggio poiché, come abbiamo visto, una 
generica mail è costituita "necessariamente" da 
testo puro. Un modo per risolvere il problema è 
quello applicare al nostro file un algoritmo tale 
da convertirlo in una forma che possa essere in- 
clusa all'interno della struttura della mail, ma 
che non "interferisca" con il testo stesso. L'algo- 
ritmo che consente di ottenere tutto questo esi- 
ste ed è definito con il nome uuencode. Uuencode 
presuppone che il file d'input sia di tipo binario. 
Stabilito questo, estrae dal file binario 3 byte per 
volta e li converte in 4 caratteri ASCII. L'algorit- 
mo utilizzato, visto più da vicino, consiste nel: 

• Considerare i 3 byte come un'unica parola 
da 24 bit. 

• Prendere 6 bit alla volta creando 4 nuovi by- 
te. 

• Aggiungere 32 ad ogni nuovo byte per otte- 
nere un carattere di testo in formato ASCII. 

Il metodo è molto semplice e sicuramente effi- 
ciente poiché consente di ottenere, al termine di 
questa elaborazione, un file contenente soltanto 
caratteri di testo, anche se un pò più grande di 
quello originario. 

Di seguito è mostrato un piccolo esempio che 
mostra un messaggio decodificato secondo que- 
sta tecnica: 

begin 664 Allegato.txt 

%3TLN + BX@ 



end 



• Content-ID: identifica il messaggio in modo 
univoco. Questo attributo è opzionale. 

• Content-Description: rappresenta una de- 
scrizione testuale del contenuto del messag- 
gio. Anche questo attributo è opzionale. 

Per non complicare troppo questa introduzione 
ai servizi di posta elettronica, è stato voluta- 
mente omesso di descrivere più in dettaglio 
questo standard, lasciando ai più volenterosi il 
compito di approfondire l'argomento. 



LA CODIFICA UUENCODE 

Sappiamo benissimo che un mail client qualun- 



II valore 664 rappresenta un codice che consen- 
te d'indicare espressamente l'utilizzo della codi- 
fica Base64. 



CONCLUSIONI 

Ora che abbiamo gettato le basi per la compren- 
sione di un sistema di posta elettronica, possia- 
mo concludere questa puntata. La prossima vol- 
ta vedremo praticamente come applicare i con- 
cetti appena visti in un progetto in Visual Basic, 
sfruttando nel contempo questa occasione per 
dare un'occhiata ad "altri" aspetti che potrebbe- 
ro tornarci utili nella realizzazione di program- 
mi simili. 

Francesco Lippo e Alberto Lippo 
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Nmap... Reloaded! 

Mossi da quanto visto sul grande schermo ultimamente (mi riferisco 
a Matrix Reloaded), ci dedicheremo alla presentazione di un tool molto 
famoso al mondo degli hacker, conosciuto col nome di Nmap. 



Ogni hacker che si rispetti precede sem- 
pre la fase di intrusione vera e propria 
in una rete informatica con una fase ini- 
ziale di "esplorazione", nella quale viene studia- 
ta a fondo la subnet oggetto dell'attacco, cercan- 
do di raccogliere quante più informazioni possi- 
bili su di essa e sugli host presenti. Vista la natu- 
ra delle vulnerabilità, che variano da applicativo 
ad applicativo (US, Apache, NetBIOS, BIND, 
ecc.) e considerato anche che gli shellcode, i 
codici per l'esecuzione remota di shell, inseriti 
negli exploit sono specifici per ogni sistema ope- 
rativo (un exploit con shellcode per Linux Red 
Hat non funziona certo su SunOS!), appare evi- 
dente che la raccolta di quante più informazioni 
possibili sul bersaglio favorisce la riuscita di un 
attacco. 



DIMMI CHE SISTEMA SEI... 

Supponendo ad esempio di conoscere l'host tar- 
get tramite il suo indirizzo IP (ipotizziamo ad 
esempio 192.168.1.30), la prima cosa da fare per 
raccogliere le informazioni che ci servono è quel- 
la di eseguire un ping-scan per trovare tutti gli 
host attivi sulla subnet 192.168.1.*, tenendo pre- 
sente però che alcuni host potrebbero non 
rispondere ai messaggi ICMP magari perché 
protetti da un firewall. Questa prima fase esplo- 
rativa fornisce un elenco di possibili bersagli, 
utile perché spesso se un hacker non riesce a 
entrare dall'esterno su un certo host X, può cer- 
care di bucare un altro host Y della stessa rete di 
X, che magari è autorizzato ad accedere ad X. 
Una volta ottenuti gli host attivi, bisognerà cer- 
care di capire quale sistema operativo essi mon- 
tano e quali servizi e porte TCP/IP sono attive, 
perché proprio da una di queste porte l'hacker 
potrebbe riuscire ad entrare. Prima dell'avvento 
delle tecniche di OS Fingerprinting, basate sul- 
l'analisi dello stack e sulla produzione di pac- 
chetti TCP/IP anomali, i metodi più utilizzati 
erano l'analisi dei "banner" e delle porte aperte, 
che in modo abbastanza banale spesso rivelano 
quale sistema è in uso. Molti amministratori, 
incautamente, non rimuovono i banner di testo 
presenti nei demoni e nei servizi attivi su un ser- 
ver: in questo caso non c'è bisogno di alcuna tec- 



nica di fingerprinting, ma basta semplicemente 
enumerare le porte aperte sull'host e fare telnet 
su di queste aspettando il messaggio di ritorno, 
come mostra il seguente esempio: 

[neo@localhost]$ telnet target.host.com 
Trying 192.168.1.30... 
Connected to target.host.com. 
Escape character is ,A ]'. 

SunOS 5.7 

login: mot 

Dall'esempio appare evidente che abbiamo a 
che fare con un sistema SunOS versione 5.7, ma, 
purtroppo, non sempre è così semplice come in 
questo caso, spesso perché la porta 23 (telnet) 
non viene lasciata tanto grossolanamente aperta. 
In caso di "incontro ravvicinato" con un web 
server, può essere utile eseguire telnet sulla 
porta 80 e catturare il banner per capire con chi 
"abbiamo a che fare". Una volta collegati sulla 
porta 80, basta digitare il verbo "GET / HTTP 
/l .0" per avere un responso dal server. 

[neo@localhost]$ telnet target.host.com 80 

Trying 192.168.1.30... 

Connected to target.host.com (192.168.1.30). 

Escape character is l/v ]'. 

GET/ HTTP/1.0 

HTTP/1.1 301 Moved Permanently 

Date: Thu, 26 Jun 2003 08:15:47 GMT 
Server: Apache/1.3.27 (Unix) PHP/4.2.2 

Location: http://target.host.com/ 

Connection: dose 

Content-Type: text/html; charset=iso-8859-l 
<!DOCTYPE HTML PUBLIC 

"-//IETF//DTD HTML 2.0//EN"> 
<HTML><HEAD> 



Nell'header di risposta, compare quasi sempre il 
campo "Server:" in cui viene indicato il web ser- 
ver che sta dall'altra parte: è ovvio che trovan- 
dosi di fronte ad Apache (come in questo caso), 
vuol dire che quasi certamente dall'altra parte è 
in esecuzione un sistema Linux /Unix, mentre in 
presenza del banner di US (Internet Information 
Server) sarà altrettanto ovvio concludere che 




Fig. 1: Nmap è il security scanner 
creato da Fyodor, più conosciuto 
fra gli hacker. Si può scaricare libe- 
ramente dal sito http://www.inse- 
cure.org; è disponibile per sistemi 
Linux e per sistemi Windows. 



Tool di OS 
fingerprinting 



rT&l Nmap non è il solo tool per 
Y---J | effettuare il riconoscimento 
di sistemi operativi da remoto. 
L'origine di questi programmi 
risale a sire, scritto da Johan, che è 
il primo rudimentale "OS detector" 
prodotto, in grado di distinguere 
Win95, 4.4BSD o Linux dal test di 
alcuni flag TCP. Altri tool che han- 
no fatto la storia degli OS scanner, 
negli anni 1998-1999, sono che- 
ckos di Shok e SS 3.11, scritto 
dall'hacker suld e capace di identi- 
ficare ben 12 sistemi operativi di- 
versi. Successivamente Queso e in 
seguito Nmap, introdussero il con- 
cetto esteso di "fingerprint" di un 
sistema operativo basato sul 
TCP/IP stack. Di recente un altro 
tool per Linux, chiamato RINGv2, è 
stato rilasciato alla comunità ha- 
cker. 
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Fig. 2: Il porting di Nmap su piatta- 
forme Windows richiede la presen- 
za delle librerie Winpcap, preleva- 
bili dal Politecnico di Torino all'in- 
dirizzo http:/ /netgroup-serv. 
polito.it/winpcap/. 



http: //www. ioprogrammo.net 



t t 



2 



3 ►►► 



49 



d e 



o g 




Fig. 3: Nmap all'opera sotto Linux. 
Il tool rileva in pochi secondi le 
porte aperte e i servizi ad esse as- 
sociati, identificando (parametro 
-O) anche il tipo di sistema opera- 
tivo (Linux Kernel) grazie alle tec- 
niche di OS fingerprinting. 




Fig. 4: Nmap per Windows è dota- 
to di una comoda interfaccia grafi- 
ca (GUI) che consente di lanciare 
le scansioni specificando i para- 
metri in maniera diretta. Prima di 
eseguire una scansione è necessa- 
rio avviare il servizio di Nmap dal- 
la finestra Service dell'interfaccia 
grafica (Start Service). 
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siamo in presenza di Windows 2000/XP (4.0/5.0 
nel primo caso, 5.1 nel secondo). Altri banner 
utili si possono ricavare comunque dai servizi 
FTP, SSH, SMTP e POP3, rispettivamente sulle 
porte di accesso 21, 22, 25 e 110 (nell'esempio che 
segue sono mostrati alcuni esempi di connessio- 
ni molto comuni). Sotto Windows può essere 
invece interessante collegarsi alle porte NetBIOS 
(135/139) con un samba client per indagare sul 
dominio e sulla versione del LAN Manager: 

[neo@localhost]$ ftp target.host.com 
Connected to target.host.com 
220 Serv-U FTP Server v4.0 for WinSock ready. .. 
Name (target. host.com :root): root 
331 User name okay, need password. 
Password: 

[neo@localhost]$ ssh -v 192.168.1.30 
OpenSSH_3.4pl, SSH protocols 1.5/2.0, OpenSSL 

0x0090609f 
[neo@localhost]$ smbelient -L 192.168.1.30 
added interface ip=192. 168. 1.30 

bcast= 192. 168. 1.255 nmask=255.255.255.0 
session request to 192.168.1.30 failed (Called 

name not present) 
session request to 192 failed (Called name not 

present) 
Password: 

Anonymous login successful 
Domain = [TARGET-DOMAIN] OS = [Windows 5.0] 

Server= [Windows 2000 LAN Manager] 

Sharename Type Comment 



Fig. 5: Windows XP non è del tutto 
compatibile con Nmap, di conse- 
guenza è consigliabile usare l'op- 
zione "Force RAW Socket" durante 
le scansioni. Tale opzione richiede 
i privilegi di Administrator. 



Error returning browse list: 

NT STATUS ACCESS DENIED 



ANALISI DELLE PORTE 

La tecnica di analizzare i banner di risposta dei 
servizi attivi fornisce quasi sempre risultati inte- 
ressanti, ma in molti casi gli amministratori più 
accorti disabilitano i banner dei servizi per ren- 
dere più difficile il compito degli hacker. In que- 
sti casi occorre ricorrere ad un'altra tecnica, det- 
tata dal buon senso e dall'intuito, che riguarda 
l'analisi delle porte aperte. Lo studio delle porte 
aperte, e dei servizi in esecuzione, spesso rivela 
in maniera esatta che tipo di sistema è in esecu- 
zione: la presenza di porte come la 23 (telnet) o 
la 22 (ssh) su una macchina Windows è alquan- 
to inverosimile, così come la presenza delle por- 
te 135/139/445 (NetBIOS) su macchine Unix è 
da escludere. L'esistenza o meno di determinati 
numeri di porta è indicativa del tipo di servizi 
attivi, di conseguenza servizi come SSH e Telnet 
segnaleranno, con molta probabilità, macchine 
Linux /Unix, così come il servizio NetBIOS ap- 
parterrà di sicuro ai sistemi operativi di Micro- 
soft. Esistono molte altre porte significative, co- 



me la 1433/1434 che si riferisce al database MS- 
SQL Server e che identifica in maniera univoca 
un sistema Windows 2000/XP; allo stesso modo 
la 3306, relativa a MySQL, è solitamente presen- 
te su macchine Linux (anche se esiste una ver- 
sione di MySQL per sistemi Win32). Un elenco 
completo di porte e servizi corrispondenti (well 
know ports) è disponibile su Internet nei link in- 
dicati in queste pagine. Discorso diverso va fatto 
per la porta 80, sulla quale, come abbiamo visto 
prima, può trovarsi qualsiasi tipo di web server 
per diversi sistemi operativi. Resta inteso che il 
discorso sulla corrispondenza fra <porte, sistemi 
op.> è sempre concepito in termini probabilistici, 
perché nulla vieta ad un host Windows di mon- 
tare un server SSH sulla porta 22 oppure ad una 
macchina Linux di attivare il servizio Samba 
(protocollo che emula il NetBIOS di Microsoft) 
falsando quanto detto finora. Esistono comun- 
que tecniche più avanzate rispetto all'analisi di 
banner e porte, che consentono di investigare a 
fondo sul tipo di sistema operativo in esecuzio- 
ne da remoto. 



OS FINGERPRINTING 

Determinare un S.O. di una macchina mentre si 
è loggati su di essa è una cosa abbastanza sem- 
plice e non richiede particolari competenze; 
quello che invece è più complicato da fare, è 
capire il sistema in uso da remoto, senza cioè 
accedere alla macchina. L'OS Fingerprinting è il 
nome di quella tecnica in grado di determinare 
in maniera esatta (o con probabilità molto eleva- 
ta) il tipo di sistema operativo di un certo host 
attraverso l'analisi di particolari informazioni e 
caratteristiche fornite dallo stesso host. Uno dei 
tool sicuramente più noti, vista la sua semplicità 
d'uso e il fatto che è di pubblico dominio, è 
senz'altro Nmap, creato dall'hacker noto col 
nome di Fyodor (fyodor@insecure.org). Le tecniche 
di fingerprinting implementate da Nmap sono 
diverse e sono tutte basate sull'analisi dello stack 
del protocollo TCP/IP. Per completezza diremo 
soltanto che una qualsiasi connessione TCP/IP 
tra due computer viene instaurata seguendo un 
meccanismo noto come "3-Way Hand -Shaking" ', 
ovvero stretta di mano "a tre vie". 

CLIENT SERVER 

1 SYN SEQ=X * 

2 fi SEQ=Y, ACK=X+1 SYN/ACK 

3 ACK SEQ=X+1, ACK=Y+1 * 



Il client deve sincronizzarsi col server prima di 
iniziare a trasmettere dati, di conseguenza man- 
da un pacchetto di tipo SYN, che contiene anche 
un certo numero X (generato in maniera casua- 
le) detto ISN (Initial Sequenze Number). Il server, 
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da parte sua, risponde al client con un pacchetto 
di tipo SYN/ACK, nel quale dimostra di aver ri- 
cevuto il primo pacchetto spedendo una risposta 
(Acknowledgement) che corrisponde al numero 
iniziale incrementato (X+2); nello stesso passo il 
server genera un proprio numero casuale ( Y) e lo 
invia al client. La procedura si conclude quando 
il client risponde al server con un messaggio 
conclusivo di tipo ACK che contiene a sua volta 
il numero Y incrementato di una unità. A questo 
punto i due computer sono sincronizzati e pos- 
sono iniziare a scambiare dati. URFC793 detta 
proprio le specifiche di questo meccanismo, che 
nella realtà viene implementato in maniera leg- 
germente diversa da ciascun sistema operativo: 
la sostanza del protocollo non cambia tuttavia le 
scelte di implementazione lasciate alla libertà 
del costruttore (Microsoft, Sun, HP, Red Hat, Ci- 
sco) sono molteplici e sono la chiave per distin- 
guere un sistema operativo da un altro. 

TECNICHE 

DI FINGERPRINTING 

Le principali tecniche di identificazione sono 
quindi basate sull'analisi dello stack TCP/IP e 
delle risposte fornite dall'host remoto in presen- 
za di pacchetti "strani" o in presenza di condi- 
zioni che non sono contemplate nelle specifiche 
deirRFC793, condizioni che vengono gestite in 
maniera diversa da ciascun sistema operativo, a 
seconda delle scelte progettuali fatte dai costrut- 
tori. Ecco alcuni dei principali metodi conosciu- 
ti in materia di OS fingerprinting: 

• FIN probe - Viene spedito un pacchetto di 
tipo FIN (o un qualsiasi pacchetto senza il 
flag ACK o SYN) su una porta aperta e si 
attende la risposta dell'host. Le specifica 
deirRFC793 sarebbe quella di non risponde- 
re a tale pacchetto, tuttavia molte imple- 
mentazioni "fuorilegge" ritornano un mes- 
saggio di RST (Windows, CISCO, HP/UX e 
IRIX). 

• BOGUS flag probe - L'idea è quella di 
impostare un flag TCP indefinito (64 o 128) 
neirheader TCP di un pacchetto SYN invia- 
to airhost. I sistemi Linux (kernel<2.0.35) 
mantengono tale flag inalterato anche nelle 
successive risposte, gli altri sistemi operati- 
vi invece resettano la connessione. 

• SYN Flooding - Viene spedito un unico nor- 
male pacchetto di tipo SYN all'host remoto 
e in seguito si scarta la conseguente risposta 
di tipo SYN/ACK inviata dal server. Lo 
scarto (e il mancato invio dell' ACK finale) 
comporta la ritrasmissione, da parte dell' ho- 



st remoto, del pacchetto SYN/ACK. Il 
timeout fra una trasmissione e la successiva 
non viene specificato nell'RFC973, quindi 
tali valori sono scelti dai costruttori. 
Misurando i tempi di ritrasmissione fra i di- 
versi pacchetti ricevuti, si può determinare 
il sistema operativo in uso (tecnica usata 
dallo scanner RING). 

ISN sampling - L'idea è quella di identifica- 
re pattern e regolarità nella generazione dei 
numeri ISN fatta dai sistemi operativi nelle 
diverse implementazioni dello stack TCP. 
Quando infatti un host riceve un messaggio 
di SYN, genera in maniera pseudo-casuale 
un proprio numero ISN in risposta al pac- 
chetto. Inviando diversi pacchetti SYN, è 
possibile calcolare di quanto differiscono fra 
loro i diversi numeri ISN generati dall'host 
remoto e verificare quanto essi siano casuali. 



NMAP ALL'OPERA 

Nmap si può scaricare gratuitamente dal sito 
http://www.insecure.org; è disponibile in formato 
RPM e in formato TAR per sistemi Linux, ma di 
recente è stato fatto un porting del programma 
anche per piattaforma Windows 2000, grazie al- 
l'uso delle librerie Winpcap. L'installazione sot- 
to Linux è immediata, mentre sotto Windows 
invece bisogna prima installare Winpcap e solo 
successivamente installare Nmap. Sempre per 
Windows è stata resa disponibile una versione 
del programma completa di librerie Winpcap e 
di installer automatizzato; al termine dell'instal- 
lazione bisogna riavviare il PC e ricordarsi di far 
partire il servizio Nmap dalla casella Service 
dell'interfaccia grafica. Windows XP SPI non è 
del tutto compatibile con Nmap, quindi potreb- 
be non essere in grado di sfruttare a pieno que- 
sto tool (si consiglia di spuntare l'opzione Force 
Raw Socket). Per usare Nmap basta semplice- 
mente eseguire il tool da linea di comando spe- 
cificando l'host sul quale indagare (sotto forma 
di indirizzo IP o di hostname) e i parametri da 
usare: 

nmap target.host.com - Scansione delle porte del- 
l' hostname indicato 

nmap 192.168.1.30 - Scansione delle porte dell'IP 
address indicato 

nmap 192.168.1* - Scansione di un'intera sottore- 
te (192.168.1.1-255) 

nmap -O 192.168.1.30 - Scansione delle porte e 
OS fingerprinting 

big. Elia Florio 




Fig. 6: Chi ha visto il film "Matrix 
Reloaded" avrà notato la scena in 
cui Trinity si lancia con molta 
disinvoltura nell'hackeraggio di un 
server della centrale elettrica da 
disattivare. Ebbene, anche Trinity, 
nel film, usa Nmap (come si vede 
chiaramente dalla figura...). 




Fig. 7: Particolare della scena di 
"Matrix Reloaded" in cui si vede 
chiaramente che Trinity 
utilizzando Nmap "V2.5BETA25" 
riesce a individuare la porta 22 
(ssh) sul server da bucare. 
L'intrusione nel server da parte di 
Trinity avviene sfruttando un bug 
realmente esistito (SSHvl CRC32) 
e noto alla comunità hacker. 



Sul Web 



Lista completa di porte e servizi 
noti 

http://www.neohapsis.com/neolabs 
/neo-ports/neo-ports.html 

Sito Ufficiale di Nmap, gestito 
da Fyodor 

www.insecure.org 

RFC793 (DARPA TCP 
Specification) 

http://www.ietf.org/rfc/rfc793.txt 

Librerie Winpcap richieste da 
Nmap 

http://winpcap.polito.it/install/ 
default.htm 



Parametri 



Altri parametri utili per un 
uso "intelligente" di Nmap 



ai 

sono: 

-sS - Esegue una scansione delle 

porte "stealth" inviando 

pacchetti SYN e senza 

connettersi 

-PO - Scansione per sistemi che 

non rispondono al PING (protetti 

da firewall) 

-v - Verbose. Aumenta il livello 

di dettaglio nell'output prodotto 

da Nmap. 



http: //www. ioprogrammo.net 



t t 



2 



3 ►►► 51 



Torneo CRobots ► ► ► ► ► ► ► ► ► ► ► ► ► ► ► 




Torneo 

CRobots 2k3 



Crobots 
for ever 



Ogni anno, intorno al mese di 

marzo, la comunità crobotica 

inizia ad animarsi. Ci sono da 

proporre le nuove idee sugli 

sviluppi futuri del compilatore che 

poi il nostro Maurizio Camangi 

presenterà in forma di supplica al 

misterioso possessore dei 

sorgenti, c'è da organizzare il 

nuovo torneo e, ovviamente, da 

scrivere l'articolo di 

presentazione... 



di soddisfare le eventuali richieste di modifiche al com- 
pilatore. Per prima cosa dovrà riuscire a sincronizzare il 
suo codice con crobots2000 (pare che il nuovo debugger 
sia stato molto apprezzato, soprattutto da Daniele Nuz- 
zo). Poi vedremo che succederà. Personalmente troverei 
molto utile la presenza di una sorta di 'memoria storica' 
del crobot, magari da implementare sotto forma di va- 
riabili permanenti che vengano gestite dal compilatore 
in maniera trasparente per il programmatore. Ogni sug- 
geriemento, comunque, andrà valutato attentamente, 
dal momento che la compatibilità con il passato dovrà 
rimanere il criterio ispiratore di ogni futura evoluzione. 
Nel frattempo lo ringraziamo per la disponibilità e lo in- 
vitiamo a partecipare al concorso 2003 



(*) 

y-a Anche se sono 
£J sicuro che la 
cosa sia stata rece- 
pita da tutti, preciso 
che si tratta di sfot- 
tò all'indirizzo del 
bicampione. 



Nei riguardi del fortunato estensore, natural- 
mente, siamo molto selettivi: una competizione 
così importante richiede cronisti all'altezza. Il 
candidato ideale deve essere un po' fuori di testa, saper 
battere qualche lettera sulla tastiera di un PC e, necessa- 
riamente, non aver mai vinto un torneo di crobots né nu- 
trire alcuna speranza in tal senso nemmeno per il futu- 
ro. In caso contrario, infatti, come potrebbe rimanere al 
di sopra delle parti e fornire un resoconto corretto e ve- 
ritiero della manifestazione? 

Ebbene, pare che, per una singolare concomitanza di 
coincidenze, io sia rimasto l'unico in Italia a soddisfare a 
pieno titolo l'ultimo punto dell'elenco e, conseguente- 
mente, eccomi qua. 

Naturalmente sono una persona di mondo, e non serbo 
il minimo rancore nei confronti di Alessandro Carlin 
che, al contrario, si è portato a casa ben un paio di titoli 
nel giro di due anni (l'ingordo!). Posso solo esprimere il 
desiderio che questa volta sia decisamente impegnato 
con le ricerche sugli sfregamenti molecolari all'univer- 
sità di Padova e non abbia il tempo di preparare un altro 
mostro iper competitivo. In caso contrario sarà opportu- 
no cercare di squalificarlo per comportamento antispor- 
tivo(*)... 

Sistemato così il campione in carica passo a fare gli au- 
guri a un'altra colonna della nostra manifestazione: Mi- 
chelangelo Messina, infatti, ha messo su famiglia. Chis- 
sà che ora non la smetta di scrivere combattenti che 
mandano sistematicamente in crisi i miei. 
Passando alle cose serie, qualche novità profila all'oriz- 
zonte anche quest'anno. Il misterioso benefattore non è 
più solo: pare che esista un altro possessore dei sorgenti 
di crobots, tal Bill Jones, che si è fatto avanti offrendosi 



IL TORNEO. DI CROBOTS 
2K3... CHE E ORAMAI 
IMMINENTE! 

La data ufficiale non è ancora stata fissata (controllate gli 
eventuali aggiornamenti sul sito www.ioprogrammo.net 
/crobots) ma è quasi certo che, anche quest'anno, le iscri- 
zioni si chiuderanno alla mezzanotte del 31 ottobre 2003. 
Stranamente immutate le regole di partecipazione: han- 
no funzionato talmente bene la passata edizione che ab- 
biamo deciso di utilizzarle anche quest'anno. Il bando 
ufficiale sarà reperibile, al solito, presso i siti, ufficiali e 
non, dedicati all'evento. Di seguito viene comunque ri- 
portato un elenco sintetico dei principali punti. 

Modalità di iscrizione 

• È possibile inviare fino a 4 crobots alla competizione 

1. Uno dovrà rientrare al di sotto della soglia delle 500 
istruzioni comprese e parteciperà al torneo dei Mi- 
croRobot. 

2. Uno avrà a disposizione 1000 Vb di codice, e potrà 
essere iscritto alla categoria ClassicBots (in cui con- 
fluiranno anche i partecipanti alla sezione preceden- 
te). 

3. Il terzo potrà sfruttare l'intero limite di indirizza- 
mento consentito dal compilatore (2000 VirtuaByte) 
e disputerà il Torneo Generale (nel quale si sfideranno 
i robot di tutte e tre le classi di peso). 

4. Il quarto concorrente, infine, sarà a discrezione del 
programmatore, che potrà scegliere in quale delle tre 
precedenti categorie far rientrare la sua opera. 

• Il numero dei robot non è, ovviamente, vincolante: 
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fermo restando il limite superiore di quattro unità 
per autore, è possibile partecipare all'evento anche 
con un unico combattente. 

Modalità di combattimento 

• I robot andranno spediti all'indirizzo di posta elet- 
tronica ascheri@edmaster.it (oppure inviati con gli al- 
tri mezzi previsti nel bando). 

• Tutti i robot arrivati saranno divisi in gruppi di al 
massimo 32 programmi (sempre nel caso, natural- 
mente, che il loro numero ecceda tale cifra), che di- 
sputeranno i gironi eliminatori. Questi forniranno i 
nomi, sia direttamente che tramite ripescaggio, dei 
qualificati per la fase finale. 

I crobot si affronteranno, in tutte le fasi della competi- 
zione, secondo due modalità differenti: 

1. Nello scontro 4vs4, naturalmente, ad ogni match 
partecipano quattro robot. Ogni sfidante deve in- 
contrare ciascuno degli avversari almeno 2000 volte: 
il fattore di ripetizione varierà quindi a seconda del- 
l'ampiezza del girone. 

2. Nello scontro F2F, invece, ogni robot affronta a sin- 
goiar tenzone ciascuno dei componenti del girone, 
con un fattore di ripetizione pari a 2000. 

Per ridurre la durata degli incontri, viene posto il "limi- 
te temporale" dei 200.000 cicli virtuali di CPU, al termi- 
ne dei quali la partita viene dichiarata patta tra i soprav- 
vissuti. 

• I punteggi saranno assegnati secondo lo schema 

Pranzo: 

• 12 punti al robot vittorioso; 

• 3 punti ai superstiti di un pareggio a due; 

• 2 punti ai superstiti di un pareggio a tre; 

• 1 punto ai superstiti di un pareggio a quattro con 
danni superiori al 40%; 

• punti ai superstiti di un pareggio a quattro con 
danni inferiori al 40%; 

• La classifica finale uscirà dal mixaggio tra le due gra- 



duatorie, con pesi 5*4 vs4 e 1*F2F, per sottolineare la 
difficoltà dello scontro a 4. 

• La finale sarà disputata secondo le stesse regole. 

La sfida è dunque lanciata, accorrete numerosi! 
Nutro la speranza che, accanto a quanti hanno rispo- 
sto all'appello inoltrato in mailing list (molti dei quali 
sono dei nuovi arrivati) si rifaccia vivo anche quel Da- 
rio Serino che non solo dominò il torneo2k con Daryl.r, 
lanciando la moda dei robot che presidiano a oltranza 
il proprio angolo naturale, ma, da matricola, rese mol- 
to difficile la vita al vincitore nel 1999 e, da campione, 
difese benissimo il titolo nel 2001. 
Anche quest'anno ioProgrammo, sponsor della mani- 
festazione, mette in palio un fantastico drive Iomega 
Zip 750MB come premio per il vincitore della compe- 
tizione e ad estrazione fra tutti i partecipanti il nuovo 
Iomega HDD Portable Hard Drive e lo strepitoso pac- 
chetto McAfee Virus Scan. Quanti fossero interessati 
potranno ispirarsi all'enorme quantità di robot inviati 
dagli autori negli ultimi 13 anni, che coprono tutte le 
categorie in cui si articolerà la manifestazione: 500, 
1000 e 2000 istruzioni. Visitate i siti dedicati a Crobots 
nonché il materiale presente sul CD-Rom per reperire 
tutto il materiale necessario allo sviluppo di un com- 
battente agguerrito. Già che siete nei paraggi, non di- 
menticate di scaricare anche i vari programmi acces- 
sori che semplificano il processo di sviluppo di un 
automa: Torneo XP (per la gestione di tutti i tipi pre- 
visti di competizione), Count 8.3 (che consente di cal- 
colare le classifiche e effettuare analisi statistiche sui 
risultati), Ecat (necessario per una rapida 'taratura' 
automatica dei parametri della vostra creatura), PPC 
(preprocessore di comandi che aggiunge #include e 
Mefine al compilatore) CRH2.0) e il suo antagonista, 
TorneoGUI (per coordinare il lavoro dei software pre- 
cedenti). Mi pare che anche per questa volta sia tut- 
to. Dopo gli auguri di rito, non mi resta che dirvi: 
iscrivetevi alla mailing list ufficiale di crobos (cro- 
bots@ioprogrammo.net) e ... fatevi sotto!!!! 

Simone Ascheri, 

Maurizio Camangi 

Michelangelo Messina 




Torneo 

CRobots 2k3 
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Tips&Tricks 



I trucchi 
del mestiere 



La rubrica raccoglie trucchi e piccoli pezzi di codice che solitamente non trovano posto nei manuali, ma sono frutto dell'esperienza di 
chi programma. Alcuni trucchi sono proposti dalla Redazione, altri provengono da una ricerca sulla Rete delle Reti, altri ancora ci 
giungono dai lettori. Chi vuole contribuire potrà inviarci i suoi tips&tricks preferiti che, una volta scelti, verranno pubblicati nella 
rubrica. Il codice completo dei tips lo trovate nel CD allegato nella directory \tips\. 



► VB.NET 



► ►►►►►►►► 



r 



Come "ricercare" una finestra 
tra quelle aperte in Windows 



Questa procedura permette di "andare alla ricerca" partendo da 
una finestra base (per esempio quella di background di Win- 
dows il cui handle è facilmente ricavabile - attraverso l'utilizzo 
della API GetDesktopWindow (Public Declare Function GetDesk- 
topWindow Lib "user32 " Alias "GetDesktopWindow" () As Long), di 
una determinata finestra o sotto-finestra avente come caption il 
testo indicato come parametro di funzione. In ambiente Win- 
dows XP se si cerca una finestra con caption "Start" si può otte- 
nere Thandle del bottone "START" della barra di controllo; di 
conseguenza è possibile cambiare il testo in esso contenuto. 
Tip fornito dal Sig. S. Tubini 

Option explicit 

Private Declare Function GetWindow Lib "user32" Alias "GetWindow" 

(ByVal hwnd As Long, ByVal wCmd As Long) As Long 
Public Declare Function GetDesktopWindow Lib "user32" () As Long 
Public Declare Function Istrlen Lib "kernel32" Alias "IstrlenA" 

(ByVal IpString As String) As Long 

Public Declare Function GetWindowTextLength Lib "user32" Alias 

"GetWindowTextLengthA" (ByVal hWnd As Long) As Long 

Private Declare Function GetWindowText Lib "user32" Alias 

"GetWindowTextA" (ByVal hwnd As Long, ByVal IpString 
As String, ByVal cch As Long) As Long 
Private Declare Function SetWindowText Lib "user32" Alias 

"SetWindowTextA" (ByVal hwnd As 

Long, ByVal IpString As String) As Long 
Private Const GW_CHILD = 5 
Private Const GWJHWNDNEXT = 2 

Public Function SearchWindow(hWnd As Long, sCaption As String) As Long 
On Locai Error Resumé Next 
Dim HI As Long, T As String, T23 As String 
HI = GetWindow(hWnd, GW_CHILD) 
If HI = Then Exit Function 
T = FindWindowsText(Hl) 
If T = sCaption Then 

SearchWindow = HI: Exit Function 
End If 

If GetWindow(Hl, GW_CHILD) > Then 
SearchWindow = SearchWindow(Hl, sCaption) 
If SearchWindow <> Then Exit Function 
End If 
Do 

HI = GetWindow(Hl, GW_HWNDNEXT) 
If HI = Then Exit Function 



T = FindWindowsText(Hl) 
If T = sCaption Then 

SearchWindow = HI: Exit Function 
End If 

If GetWindow(Hl, GW_CHILD) > Then 

SearchWindow = SearchWindow(Hl, sCaption) 
If SearchWindow <> Then Exit Function 
End If 
Loop Until HI = 
End Function 

Public Function FindWindowsText(hWnd As Long) As String 

FindWindowsText = String$(GetWindowTextLength(hWnd) + 1, vbNull) 
GetWindowText hWnd, FindWindowsText, Len(FindWindowsText) 
FindWindowsText = Left(FindWindowsText, Istrlen(FindWindowsText)) 
End Function 

Public Function ChangeWindowsCaption (hWnd As Long,sTxt As String) 
SetWindowText hWnd, sTxt 
End Function 

Un conto alla rovescia per arrestare 
il sistema 

Un tip per spegnere il computer dopo un determinato periodo 
di tempo. In caso di chiusura del programma, esso risponderà 
come se il tempo fosse scaduto. Per il corretto funzionamento si 
consiglia di inizializzare i due controlli timer con i seguenti va- 
lori di proprietà: 

Timer Jempo: Intervallo 1000 / Enabled = False 
Timer _contr olio: Intervallo 200 / Enabled = True 

Tip fornito dal Sig. M. Bruseghin 



Private Sub Timer_tempo_Timer() 


If IbITempos. Caption 


= And IbITempom. Caption = 

And IbITempoh. Caption = Then 


Timer_tempo. Enabled = False 


Else 


IbITempos. Caption = 


IbITempos. Caption - 1 


End If 


If IbITempos. Caption 


< Then 


IbITempom. Caption = 


= IbITempom. Caption - 1 


IbITempos. Caption = 


59 


End If 


If IbITempom. Captior 


i < Then 


IbITempoh. Caption = 


IbITempoh. Caption - 1 


IbITempom. Caption = 


: 59 


End If 


If IbITempoh. Caption 


< Then 


IbITempoh. Caption = 
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IbITempom.Caption = 59 

End If 

If IbITempoh.Caption = Then 

IbITempoh.Caption = 

End If 

If IbITempos.Caption = Then 

If IbITempom.Caption = Then 

If IbITempoh.Caption = Then 

Timer_tempo.Enabled = False 

FormI.Show 

MsgBox "Tempo scaduto!", vbOKOnly + vbExclamation, "Arresto sistema 

in corso..." 

' per Windows 98 

Shell ("C:\WINDOWS\RUNDLL.EXE user.exe,exitwindows") 

'per Windows XP 

Shell ("C:\WINDOWS\RUNDLL32.EXE user,exitwindows") 

End 

End If 

End If 

End If 

End Sub 

Private Sub Timer_controllo_Timer() 

If IbITempos.Caption = And IbITempom.Caption = 

And IbITempoh.Caption = Then 
cmdAccendi.Enabled = False 
Else 

If Timer_tempo.Enabled = False Then 
cmdAccendi.Enabled = True 
End If 
End If 
End Sub 

'codice dei vari CommandButton 
Private Sub cmdAccendi_Click() 
Timer_tempo.Enabled = True 
cmdAccendi.Enabled = False 
End Sub 

Private Sub cmdStop_Click() 
Timer_tempo.Enabled = False 

If IbITempoh.Caption = And IbITempom.Caption = And 
IbITempos.Caption = Then 
cmdAccendi.Enabled = False 
Else 

cmdAccendi.Enabled = True 
End If 
End Sub 

Private Sub cmdImpostaTime_Click() 
If Timer_tempo.Enabled = False Then 
cmdAccendi.Enabled = False 
End If 

If txtOra.Text > "24" Then 
MsgBox "Il Timer dell'ora non è accettabile", vbOKOnly + vbCritical, 

"Errore MB 
Timeout! 1.0" 
txtOra.Text = "" 
txtOra.SetFocus 
Else 

IbITempoh.Caption = txtOra.Text 
End If 
If txtMinuti.Text > "59" Then 



MsgBox "Il Timer dei minuti non è accettabile", vbOKOnly + vbCritical, 

"Errore MB 
Timeout! 1.0" 
txtMinuti.Text = "" 
txtMinuti.SetFocus 
Else 

IbITempom.Caption = txtMinuti.Text 
End If 

If txtSecondi.Text > "59" Then 
MsgBox "Il Timer dei secondi non è accettabile", vbOKOnly + 

vbCritical, "Errore MB 
Timeout! 1.0" 
txtSecondi.Text = "" 
txtSecondi.SetFocus 
Else 

IbITempos.Caption = txtSecondi.Text 
End If 

If txtOra.Text = "" Then 
IbITempoh.Caption = 
End If 

If txtMinuti.Text = "" Then 
IbITempom.Caption = 
End If 

If txtSecondi.Text = "" Then 
IbITempos.Caption = 
End If 
End Sub 

Private Sub optImpostazioni_Click() 
txtOra.Enabled = False 
txtMinuti.Enabled = False 
txtSecondi.Enabled = False 
cmdlmpostaTime.Enabled = False 
cmdStop.Enabled = False 
End Sub 

Private Sub Form_Unload(Cancel As Integer) 
MsgBox "Chiusura non consentita", vbOKOnly + vbCritical, 

"Arresto sistema in corso..." 
' per Windows 98 

Shell ("C:\WINDOWS\RUNDLL.EXE user.exe,exitwindows") 
'per Windows XP 

Shell ("C:\WINDOWS\RUNDLL32.EXE user,exitwindows") 
End 
End Sub 

Come copiare una lista di IP 
in un vettore 

Spesso su internet si trovano lunghissime liste di IP (Internet 
Protocol). Volendo creare un programma per gestire tali indiriz- 
zi è comodo averli sotto forma di vettori. Il tip proposto prende 
in considerazione gli ip nella forma: 255.255.255.255:8080 prele- 
vati da un controllo textbox e poi spezzettati in due array sem- 
plici: ip() e port() 
Tip fornito dal Sig. S. Rinaldo 

Private Sub Commandl_Click() 
Dim tempO As String 
Dim ip() 
Dim port() 
Dim fine As Integer 
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Dim i, j As Integer 

temp = Split(txtIP.Text, vbCrLf) 

j = -1 

For i = LBound(temp) To UBound(temp) 
fine = InStr(l, temp(i), ":") 
If ((fine > 7) And (fine < 17)) Then 
j =j + 1 

ReDim Preserve ip(j) 
ReDim Preserve port(j) 
ip(i) = Mid(temp(i), 1, fine - 1) 
port(i) = Mid(temp(i), fine + 1, Len(temp(i))) 
End If 
Next i 
End Sub 

Un semplice Server proxy 

Una semplice applicazione che funge da Server Proxy consen- 
tendo la condivisione e l'accesso ai documenti ipertestuali del 
WEB tra tutti i computer di una rete locale. Per poterlo utilizza- 
re, all'interno del browser digitare: "http://IP_PROXY:8080/IP- 
SERVER/pagina.htm 
Tip fornito dal Sig. M.Nicosia 

Option Explicit 

Dim i As Integer 

Private Sub delay(interval As Single) 

Dim s As Single 

s = Timer 

Do While Timer < (s + interval) 

DoEvents 
Loop 



End Sub 

Private Sub parse(buffer As String, ByRef server As String, 

ByRef richiesta As String) 
On Error Resumé Next 
Dim uri As String 

uri = Left$(buffer / InStr(buffer, "HTTP/1.1") - 2) 
uri = Right$(url / Len(url) - 5) 
If InStr(url, "/") = Then 

server = uri 

richiesta = "GET /" 
Else 

server = Left$(url, InStr(url, "/") - 1) 

richiesta = "GET " & Right$(url / Len(url) - Len(server)) & vbCrLf 
End If 
End Sub 

Private Sub Form_Load() 
wskserver.LocalPort = 8080 
wskserver.Listen 
i = 
End Sub 
Private Sub wskconnect_DataArrival(Index As Integer, ByVal 

bytesTotal As Long) 
On Error Resumé Next 
Dim buffer As String 
Dim server As String 
Dim richiesta As String 
wskconnect(Index).GetData buffer 
parse buffer, server, richiesta 
Load wskweb(Index) 
wskweb(Index).Connect server, 80 
delay 1 



IL TIP-ONE del mese 




finally 

LinkStream. Free; 
end; 


. %\ Convertire un filmato flash 






kjl in EXE 




SourceStream := TFileStream. Create(S, fmOpenRead or 


Il tip consente di convertire un qualunque filmato forma 


to Macro- 


fmShareExclusive); 


media Flash in un comune file eseguibile di Windows, ovvero un 


try 


.EXE. Si tratta di una funzione che accetta tre argomenti: 


:il file sor- 


DestinyStream. Copy From(SourceStream, 0); 


gente (file formato Flash), il file di destinazione (file .exe) e il per- 


flag := $FA123456; 


corso del Flash Player installato nel proprio sistema. 




DestinyStream. WriteBuffer(flag, sizeof(integer)); 


Tips fornito dal sig. G. Cassano 




SwfFileSize := SourceStream. Size; 

DestinyStream. WriteBuffer(SwfFileSize, sizeof(integer)); 


function Swf2Exe(S, D, F: string): string; 




result := "; 
finally 

SourceStream. Free; 
end; 
finally 

DestinyStream. Free; 
end; 
end; 

procedure TForml.ButtonlClick(Sender: TObject); 


var 




SourceStream, DestinyStream, LinkStream: TFileStream; 




flag: Cardinal; 




SwfFileSize: integer; 




begin 




result := 'something error'; 




DestinyStream := TFileStream. Create(D, fmCreate); 




try 




LinkStream := TFileStream. Create(F, fmOpenRead or 




fmShareE 


Exclusive); 


begin 

Swf2Exe('c:\prova.swf, 'c:\provai.exe', 'D:\FlashPla.exe'); 
end; 


try 




DestinyStream. CopyFrom(LinkStream, 0); 
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wskweb(Index).SendData richiesta 

End Sub 

Private Sub wskconnect_SendComplete(Index As Integer) 

wskconnect(Index).CIose 

wskweb(Index).CIose 

Unload wskconnect(Index) 

Unload wskweb(Index) 

End Sub 

Private Sub wskserver_ConnectionRequest(ByVal requestlD As Long) 

i = i + 1 

Load wskconnect(i) 

wskconnect(i).Accept requestlD 

delay 1 
End Sub 
Private Sub wskweb_DataArrival (Index As Integer, ByVal bytesTotal As Long) 

On Error Resumé Next 

Dim risposta As String 

wskweb(Index).GetData risposta 

wskconnect(Index).SendData risposta 
End Sub 

Come calcolare il crc32 di alcune 
tipologie di dati 

La semplice applicazione Visual Basic permette di calcolare il 
CRC32 di una stringa, di una array di byte o di un file. Ricordiamo 
che il controllo del CRC32 consente, mediante una tecnica di codifi- 
ca dei bit, di ottenere un elevato grado di protezione del messaggio 
in oggetto, grazie alla rilevazione di un'alta percentuale d'errori. 
Tip fornito dal Sig. S .Tubini 

Option Explicit 

Private Declare Sub CopyMemory Lib "kernel32" Alias "RtIMoveMemory" 
(Destination As Any, Source As Any, ByVal Length As Long) 
Private crc32table(255) As Long 
Private Crc32TableSet As Boolean 

Public Sub CreateTable(Optional IPolinomio As Long = &HEDB8832Q) 
Dim I As Long 
Dim j As Long 
Dim ICrc As Long 
For I = 1 To 255 Step 1 
ICrc = I 
j = 8 

For j = 1 To 8 Step 1 
If (ICrc And 1) Then 
ICrc = ((ICrc And &HFFFFFFFE) \ 28Q And &H7FFFFFFF 
ICrc = ICrc Xor IPolinomio 
Else 

ICrc = ((ICrc And &HFFFFFFFE) \ 28Q And &H7FFFFFFF 
End If 
Next 

crc32table(I) = ICrc 
Next I 

Crc32TableSet = True 
End Sub 

Public Function CalcCRC32(ByteArr() As Byte) As Long 
Dim I As Long 
Dim CRC32Val As Long 
Dim ArrLen As Long 
Dim LongBytes(3) As Byte 



If (Not Crc32TableSet) Then CreateTable 

CRC32Val = -1 

ArrLen = UBound(ByteArrQ) 

For I = To ArrLen Step 1 

SplitLongValues CRC32Val, LongBytesQ: LongBytes(3) = 
CRC32Val = crc32table((CRC32Val Xor ByteArr(I)) And &HFF) 
CRC32Val = CRC32Val Xor MergeLongValues(LongBytes()) 
Next 

CalcCRC32 = CRC32Val 
End Function 

Public Function CalcCRC32FromString(sStr As String) As Long 
Dim bArrQ As Byte, I As Long 
If Len(sStr) > Then 

ReDim bArr(0 To (Len(sStr) - 1)) As Byte 
For I = 1 To Len(sStr) Step 1 

bArr(I - 1) = Asc(Mid(sStr, I, 1)) 
Next 

CalcCRC32FromString = CalcCRC32(bArrQ) 
End If 
End Function 

Public Function CalcCRC32FromFile(sFile As String) As Long 
On Locai Error Resumé Next 
Dim bArrQ As Byte, I As Long, L As Long 
If FileLen(sFile) > Then 

If Err <> Then Err = 0: Exit Function 
ReDim bArr(Q To (FileLen(sFile) - 1)) As Byte 
L = FreeFileQ 
Open sFile For Binary As L 

Get L, , bArrQ 
Close L 

CalcCRC32FromFile = CalcCRC32(bArrQ) 
End If 
End Function 
Public Sub SplitLongValuesQValue As Long, ByteArrQ As Byte) 

CopyMemory ByteArr(O), IValue, 4 
End Sub 
Public Sub SplitlntegerValuesQValue As Integer, ByteArrQ As Byte) 

CopyMemory ByteArr(Q), IValue, 2 
End Sub 
Public Function MergeLongValues(ByteArr() As Byte) As Long 

CopyMemory MergeLongValues, ByteArr(O), 4 
End Function 
Public Function MergeIntegerValues(ByteArr() As Byte) As Integer 

CopyMemory MergelntegerValues, ByteArr(O), 2 
End Function 
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Come creare una directory 



L'argomento è la creazione di una directory con la classe File conte- 
nuta nel package java.io. Per creare una cartella del tipo: c:\program- 
mi\java\esempio. Si può usare il metodo mkdirO della classe File sud- 
detta, ma, ahimè, tale metodo non permette di creare la cartella 
"esempio" se la cartella Java non è stata creata precedentemente e la 
stessa considerazione vale per la cartella padre "programmi" . Una 
semplice soluzione può essere quella di utilizzare lo StringTokenizer 
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per creare ricorsivamente le sottocartelle. 

Tip fornito dal Sig. M. Barbaro 

StringTokenizer token Directory = new StringTokenizer( 

percorsoCompleto, "\\"); 
StringBuffer stringaSottoDirectory = new StringBuffer(""); 
while(tokenDirectory.hasMoreElements()) { 

stringaSottoDirectory. a ppend (token Di rectory.nextToken()) 

■append("\\"); 
File sotto Directory = new File(stringaSottoDirectory.toString()); 
if(!sottoDirectory.exists()) { sotto Di recto ry.mkdir(); } 
} 



^ € + + /€#►►►►►►►►►►►►►► 

Come controllare la porta 
parallela da qualunque 
sistema Operativo 

Il controllo delle porte I/O è un problema delicato, ove il 
software e l'hardware arrivano a sfiorarsi. È possibile inviare al 
PC istruzioni maldestre che compromettono il funzionamento 
della macchina. Per scongiurare eventuali problemi, i sistemi 
operativi della Microsoft dopo NT4 hanno preso il controllo 
completo delle porte I/O. Le istruzioni di lettura e scrittura co- 
me pori nel PASCAL e inp nel C generano un errore istruzione 
privilegiata terminando il flusso del programma. Per questo 
motivo negli articoli di elettronica applicata pubblicati da que- 
sta rivista si specifica si utilizzare come sistema operativo Win- 
dows 98 o 95. Il problema si risolve utilizzando un driver. Ad 
esempio si può sfruttare PortTalk Driver for Windows NT/2000/XP 
downlodabile da http:// www.beyondlogic.org. Questo driver fun- 
ziona correttamente con i sistemi Windows NT/2000 /XP ( in al- 
legato trovate il file porttalk22.zip con la documentazione uffi- 
ciale). Rimane il problema di non conoscere a priori il sistema 
operativo della macchina. 
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Fare clic su :ilicazione 

Fare clic su Annulla per eseguire il debug dell'applicazione 
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Come sospendere l'esecuzione 
di un programma 

A volte è necessario sospendere l'esecuzione di un'applicazione 
per un determinato periodo di tempo. La funzione "pausa" 
scritta in C+, ed oggetto di questo tip, fa proprio al caso nostro: 
sospende, infatti, V esecuzione di un programma per un inter- 
vallo di tempo espresso in secondi. Di seguito viene riportato il 
listato corredato da un esempio di utilizzo. 
Tip fornito dal Sig. R.Pizzolante 

#include <iostream.h> 
#include <time.h> 
/*funzione pausa*/ 
void pausa(double sec) { 

clock_t t = (clock_t)(clock() + (CLOCKS_PER_SEC * sec)); 

while (clockQ < t); 



return; } 
/*Esempio di utilizzo : 

stampa la stringa puntata da s con effetto "macchina da scrivere" */ 
int main(void) { 
char *s = "Raffaele Pizzolante"; 
for ( ; *s; s++) { 
cout << *s; 

pausa(1.0 / 5.0); /*l/5 di secondo*/ } 
return 0; } 

Come monitorare i processi 
di Windows 

Questo tip mostra come sia possibile monitorare i processi di 
Windows con un'applicazione C#. In particolare si possono ot- 
tenere dettagliate informazioni riguardanti l'ID del processo, la 
memoria utilizzata, il modulo principale, etc; La classe "Pro- 
cess " del Namespace " System. Diagnostic " consente, inoltre, di in- 
viare un segnale "Kill " ai processi attivi. 
Tip fornito dal Sig D.Camassa 

private void startMonitor() { 

while(true) { 

//Per l'aggiornamento dell'albero è necessario utilizzare un delegato 
ProcessTree.BeginInvoke(new UpdateTree(UpdateTreeDelegate)); 
//Refresh ogni 10 secondi 
thProcessJoin(5Q00);> } 
private void UpdateTreeDelegate(){ 
ProcessTree.Nodes[0].Nodes.Clear(); 
ProcessTree.BeginUpdate(); 
//ottengo un array dei processi attivi 
process=System.Diagnostics.Process.GetProcesses(); 
//costruisco l'albero dei processi 
for(int i=0;i<process.Length;i++) { 
ProcessTree.Nodes[0].Nodes.Add(new 
TreeNode(process[i].ProcessName,l,l)); } 
ProcessTree.EndUpdate(); 

//Riseleziono l'ultimo nodo scelto prima del refresh 
ProcessTree.SelectedNode=ProcessTree.Nodes[0].Nodes[ 

SelectedNodelndex];} 
private void ProcessTree_AfterSelect(object sender, 

System. Windows. Forms.TreeViewEventArgs e) { 
if(!(((TreeView)sender).SelectedNode.Text.Equals("Processi"))) { 
try { 

SelectedNodeIndex=ProcessTree.SelectedNode. Index; 

Process pr=Process.GetProcessById(process[((TreeView)sender). 

SelectedNode.Indexj.Id); 

StringBuilder sb=new StringBuilder(); 

//Ottengo tutte le informazioni sul processo selezionato 

sb.Append("Name:"+pr.ProcessName+"\n"); 

sb.Append("ID:"+pr.Id+"\n"); 

sb.Append("Priorità:"+pr.BasePriority+"\n"); 

sb.Append("Handle:"+pr.Handle +"\n"); 

sb.Append("Modulo principale :"+pr.MainModule+"\n"); 

sb.Append("Dimensione della memoria 

privata :"+pr.PrivateMemorySize +"\n"); 

sb.Append("Avvio:"+pr.StartTime +"\n"); 

sb.Append("thread:"+pr.Threads+"\n"); 

sb.Append("Tempo utente di processore: "+ 

pr.UserProcessorTime +"\n"); 
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sb.Append("Memoria virtuale usata :"+ 

pr.VirtualMemorySize+"\n"); 
InformationProcess.Text=sb.ToString(); } 
catch(Exception err) { 

InformationProcess.Text="Errore nella lettura delle informazioni: 

"+err.Message; } 
} 
> 

private void menuIteml_Click(object sender, System. EventArgs e) { 
//ATTENZIONE: Uccido il processo selezionato 
try { 

process[ProcessTree.SelectedNode. Index]. Kill(); 
ProcessTree.SelectedNode=ProcessTree.Nodes[0].Nodes[0]; } 
catch(Exception er){MessageBox.Show("Errore: "+er.Message); 
__} 
> 

Riconoscere il sistema operativo 

Per risolvere questo problema si è definita una classe Cport che, oltre 
incorporare il codice di gestione del driver va a riconoscere il sistema 
operativo. Questa operazione è svolta dalla seguente funzione 

BOOLCPort::GetOpSystem() { 

OSVERSIONINFO *osvi; 

osvi = new(OSVERSIONINFO); 

osvi->dwOSVersionInfoSize=sizeof(OSVERSIONINFO) ; 

GetVersionEx (osvi); 

blsWindowsNTorLater = (osvi->dwPlatformId = = 

VER_PLATFORM_WIN32_NT ); 

try {delete osvi;} 

catch(...){;>; 

return blsWindowsNTorLater; 
} 

per cui prima di leggere /scrivere il valore della porta si controlla il 
tipo di sistema operativo: 

unsigned char CPort: :inport(unsigned short PortAddress) { 
if (! blsWindowsNTorLater) { return _inp(PortAddress); 

}; 

unsigned int error; 
DWORD BytesReturned; 
unsigned char Buffer[3]; 
unsigned short * pBuffer; 
pBuffer = (unsigned short *)&Buffer; 
*pBuffer = PortAddress; 

error = DeviceIoControl(PortTalk_Handle, IOCTL_READ_PORT_UCHAR, 
&Buffer, 2, &Buffer, 1, &By tes Return ed, NULL); 
if (lerror) 

AfxMessageBox("Errore di comunicazione con il driver", MB_OK,0); 
return(Buffer[Q]); } 
void CPort: :outport(unsigned short PortAddress, unsigned char byte) 

{ 

if (IblsWindowsNTorLater) { 
_outp(PortAddress,byte); 
return; }; 
unsigned int error; 
DWORD BytesReturned; 
unsigned char Buffer[3]; 



unsigned short * pBuffer; 
pBuffer = (unsigned short *)&Buffer[0]; 
*pBuffer = PortAddress; 
Buffer[2] = byte; 

error = DeviceIoControl(PortTalk_Handle,IOCTL_WRITE_PORT_UCHAR, 
&Buffer, 3, NULL, 0, &BytesReturned,NULL); 
if (lerror) 

AfxMessageBox(" Errore di comunicazione con il driver",MB_OK,0); 



> 



L'utilizzo della classe è molto semplice. Bisogna dichiarare una va- 
riabile di tipo Cport e assegnare il corretto valore air indirizzo. A que- 
sto punto l'operazione di lettura è svolta attraverso il metodo leggi 
che aggiorna le proprietà value (valore decimale della variabile), e 
bit[i] (array contenente i singoli bit). L'operazione di scrittura avvie- 
ne sul singolo bit attraverso il metodo setout(unsigned int value, unsi- 
gned char bitnum). Per funzionare correttamente insieme alla calsse 
Cport è necessario includere nella cartella dell'eseguibile anche il file 
porttalk.sys (il vero driver). Tutto così semplice? No. Installare un ser- 
vizio o un driver in Windows NT o 2000 o XP non è cosa da tutti! O 
meglio bisogna avere i diritti di amministratori. Questo vale solo per 
la prima volta. Basta allora far eseguire una volta il programma dal- 
l'amministratore e poi avete il controllo delle porte I/O. In allegato 
trovate un progetto per il controllo della porta parallela equivalente 
a quello pubblicato su ioProgrammo n.57-58, ma funzionante con 
tutti i sistemi operativi. 
Tip fornito dal Sig. F. Gobbi 



che ti premia 



Questo mese 
in palio un 

FANTASTICO 
MASTERIZZATORE 
WAITEC STORM 52X 





WAITEC 

STORM 

52X 



Inviaci la tua soluzione ad un problema di 

programmazione, una faq, un tip... 

Tra tutti quelli giunti mensilmente in redazione, 

saranno pubblicati i più meritevoli e, fra questi, 

scelto il "TipOne" del mese, 
PREMIATO CON UN FANTASTICO OMAGGIO! 

Invia i tuoi lavori a ioprogrammo@edmaster.it 
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S Porta parallela e infrarossi 



(parte seconda) 



Elettronica 



File sul Web - 

www.ioprogrammo.net/ 
files/ 72/ Elettronica.zip 



Infrarossi 
e wireless 

^a I moderni telefoni 
■ J cellulari ed alcuni 
PC portatili sfruttano gli 
infrarossi per stabilire 
una veloce e facile (an- 
che se lenta) connes- 
sione wireless, su inter- 
net è possibile trovare 
software e molti schemi 
per la costruzione di 
una interfaccia a infra- 
rossi standard. 



Un telecoman 
per pilotare il PC 



In questa seconda parte 

realizzeremo un ricevitore a 

infrarossi e scopriremo come 

ricevere i segnali di un 

telecomando attraverso la porta 

parallela. 



Il PC è una macchina dalle molteplici funzionalità e 
dai più disparati utilizzi, quando ci si addentra poi 
nel campo della programmazione ci si accorge del 
fatto che non esistono limiti a quello che il software 
può fare, se non quelli legati all'hardware di cui di- 
sponiamo. In effetti gli unici limiti del software che 
possiamo scrivere, sono quelli imposti dalle caratteri- 
stiche fisiche delle macchine per le quali quel softwa- 
re è progettato. Per mettere in pratica il progetto che 
ci proponiamo di realizzare, ricevere ed interpretare i 
segnali di un comune telecomando a infrarossi, abbia- 
mo bisogno, prima di tutto, di estendere i limiti del 
nostro PC. Nel caso specifico necessitiamo di una pe- 
riferica in grado di permettergli di "vedere" gli infra- 
rossi, estendendo così i suoi "sensi". In questo artico- 
lo tratteremo la realizzazione di questa periferica sia 
da un punto di vista hardware (come vedremo la sua 
costruzione non richiede particolari abilità e cono- 
scenze) sia dal punto di vista software, approfonden- 
do gli aspetti più squisitamente implementativi e i 
possibili ulteriori sviluppi. Il mese scorso abbiamo 
trattato dettagliatamente gli aspetti riguardanti le pro- 
blematiche di interfacciamento di dispositivi tramite 
le "porte" che i personal computer ci mettono a di- 
sposizione (porta parallela, porta seriale, porta joy- 
stick e USB), focalizzando la nostra attenzione su quel- 
la che, di fatto, è la più versatile e allo stesso tempo la 
più semplice da gestire, la porta parallela. Abbiamo 
così preparato le basi sulle quali si fonderà il software 
che ci apprestiamo a scrivere, basi che integreremo, 
più avanti in questo articolo, con delle nozioni di pro- 
grammazione multithread necessarie a comprendere 
alcuni elementi di questo progetto. Prima di seguire lo 
sviluppo del programma dobbiamo capire che tipo di 
segnale ci apprestiamo a ricevere /riconoscere tramite 
la nostra periferica. Vediamo, quindi, come funziona 



un tipico telecomando a infrarossi per televisore. 

COME FUNZIONA 
IL TELECOMANDO 

Ogniqualvolta premiamo un tasto del telecomando 
del nostro televisore, un circuito genera un "segnale" 
che il ricevitore del televisore è in grado di interpreta- 
re per eseguire l'operazione desiderata. Il segnale tra- 
smesso, che è ovviamente diverso per ogni tasto, non 
è altro che una stringa di "0" e "1" di una data lun- 
ghezza, in cui i valori "0" ed "1" durano un determi- 
nato lasso di tempo. Immaginate un'onda quadra, co- 
me quella in Fig. 3, nella quale ogni stato, "0" o "1", 
dura qualche millisecondo. Quando teniamo premuto 
un tasto del telecomando il segnale corrispondente 
viene ripetuto continuamente interponendo un tempo 
di pausa (di solito paragonabile alla lunghezza totale 
del segnale), tra un segnale e l'altro. Ciò che rende 
ogni tasto riconoscibile attraverso il suo segnale sono, 
in genere, i diversi tempi di permanenza degli stati 
("0" o "1"); tuttavia la lunghezza del segnale è una ca- 
ratteristica costante per ogni tasto, particolarità questa 
che rende notevolmente più semplice il riconoscimen- 
to. Da notare che anche se il tasto del telecomando vie- 
ne rilasciato proprio nel bel mezzo della trasmissione 
di un segnale, quest'ultimo viene comunque termina- 
to. In realtà quello di cui abbiamo parlato è il segnale 
già decodificato da un "ricevitore di infrarossi", un 
componente elettronico installato nel televisore e che 
useremo anche per il nostro circuito. Il segnale tra- 
smesso dal telecomando è un'onda più complessa e 
con una frequenza maggiore, creata appositamente 
per evitare disturbi e cattive interpretazioni di luce in- 
frarossa proveniente da altre fonti come le lampade ad 
incandescenza. Fortunatamente lavoreremo con il se- 
gnale già decodificato e reso "digitale" prima dell'in- 
gresso nella porta parallela. A differenza di ciò che av- 
viene in un comune televisore, il nostro software, una 
volta effettuata una breve fase di apprendimento, sarà 
potenzialmente in grado di ricevere e interpretare i se- 
gnali provenienti da un qualunque telecomando... 
Possiamo adesso capire come può essere riconosciuto 
il segnale corrispondente ad un tasto. Bisogna prima 
di tutto "campionarne" il segnale, misurando il tempo 
che intercorre tra ogni cambiamento di stato dell'onda 
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quadra e poi confrontarlo con un archivio che contie- 
ne questi dati per ogni tasto del telecomando. A tale 
scopo installeremo una interrupt service routine (ISR), 
una funzione che viene richiamata ogniqualvolta 
cambia lo stato di un pin di ingresso della porta pa- 
rallela e memorizza il tempo intercorso dall'ultimo 
cambiamento. Vedremo più avanti come alcuni fatto- 
ri, quali la velocità del nostro PC, il numero di pro- 
grammi in esecuzione, quindi la percentuale di CPU 
impegnata e Y ottimizzazione del nostro programma, 
possono incidere significativamente sulla bontà del 
campionamento che effettuiamo e, quindi, sul ricono- 
scimento del tasto stesso. Vediamo, a questo punto, 
cosa occorre per costruire il circuito e come montarlo. 

COSTRUIAMO LA NOSTRA 
PERIFERICA 

La periferica necessaria affinché il nostro PC sia in gra- 
do di "vedere" gli infrarossi è composta essenzial- 
mente da 3 componenti tutti facili da reperire e dal co- 
sto davvero irrisorio. Ci servono: un connettore per 
porta parallela (tecnicamente un connettore maschio 
D25), una resistenza da 470ohm e un ricevitore integra- 
to di infrarossi che lavori alle frequenze dei normali 
telecomandi per televisore (36-38 KHz), quello usato 
in questo esempio è un Siemens SFH-507-38. Il ricevi- 
tore integrato di infrarossi è il componente scuro con 
tre piedini che potete vedere sia in Fig. 1 che, schema- 
ticamente, in Fig. 2. Due dei tre piedini di questo com- 
ponente (quelli più vicini tra loro) servono ad ali- 
mentarlo; tensione e corrente di alimentazione sono 
compatibili con quelle fornite in output dalla porta 
parallela. Prenderemo la massa da uno dei piedini di 
massa della porta (Pin 25) e Y alimentazione diretta- 
mente dal primo piedino di output (Pin 2), così facen- 
do non dobbiamo dimenticare di porre lo stato di que- 
sto piedino ad "alto" tramite il software, diversamen- 
te il circuito non risulterà alimentato. Inoltre, colle- 
gheremo la resistenza ai capi di uno di questi piedini 
in modo da limitare la corrente assorbita e proteggere 
la porta (questa è soltanto una precauzione). Il terzo 
piedino del ricevitore integrato di infrarossi è l'output. 
Tra questo piedino e la massa varia la tensione da li- 
vello "0" a "1", rispettivamente rappresentati da 
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Ovolt(massa) e +5volt, mentre si riceve un segnale. Que- 
sti valori (come abbiamo visto nell'articolo preceden- 
te) sono direttamente compatibili con gli ingressi del- 
la porta parallela, il piedino può essere collegato, 
quindi, direttamente ad uno dei pin di ingresso della 
porta parallela. Nel nostro caso lo collegheremo al pin 
10, l'unico ingresso in grado di segnalare un interrupt 
al sistema. Come è possibile vedere in Fig. 1, l'intero 
circuito può essere montato all'interno del connettore 
stesso, lasciando esternamente il ricevitore integrato 
di infrarossi, al quale deve essere data la possibilità di 
"vedere" fisicamente il trasmettitore del telecomando. 
L'esperienza comune ci suggerisce che non è necessa- 
rio puntare il telecomando esattamente verso il ricevi- 
tore, questo è dovuto al fatto che i raggi infrarossi, co- 
me avviene per la luce visibile, rimbalzano sulle su- 
perfici. Una volta costruito, il circuito può essere col- 
legato direttamente alla porta parallela, il mio consi- 
glio è quello di farlo attraverso un cavo di prolunga in 
modo che il ricevitore non stia nascosto dietro il PC di- 
ventando, quindi, più difficile da raggiungere. 
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Fig. 1: L'interno della periferica, come si può no- 
tare è interamente contenuta nel connettore. 



Fig. 2: Schema della periferica. 

La nostra periferica è adesso pronta, come potete ve- 
dere non è nulla di particolarmente complesso, questo 
grazie anche al fatto che è possibile alimentare diret- 
tamente i componenti dalla porta parallela. L'introdu- 
zione di un circuito di alimentazione avrebbe, infatti, 
introdotto una certa complessità circuitale richieden- 
do anche qualche altro componente a protezione del- 
la porta. Per conoscere tutte le caratteristiche tecniche, 
lo schema equivalente e i dettagli sul funzionamento 
del ricevitore integrato di infrarossi è sufficiente cer- 
care il datasheet (foglio delle caratteristiche) su inter- 
net. 



INTERFACCIAMO 
LA PERIFERICA 

Come già anticipato, la porta parallela fornisce una li- 
nea di interrupt che può segnalare i cambi di livello 
che si presentano sul PIN 10 della porta, Windows for- 
nisce, però, uno strato di astrazione dall'hardware per 
garantirne l'accesso in maniera sicura e da parte di più 
utenti, per questo motivo la lettura /scrittura sulle 
porte e la gestione dell'interrupt non possono essere 
gestiti direttamente, ma devono essere effettuati tra- 
mite un driver. Su internet è possibile trovare nume- 
rosi driver freeware o shareware, il driver che usere- 



E vi tare 
i disturbi 

r& Quando si lavora 
^■J con gli infrarossi 
spesso si usano dei filtri 
di "plastica" scura per 
filtrare "luci" indeside- 
rate che potrebbero al- 
terare il campionamen- 
to, basta guardare un 
comunissimo televisore 
per notare questo ac- 
corgimento. 
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Elettronica 



Un telecomando 

per pilotare il PC 



La pressione 
lunga 

~& Moltissimi teleco- 
- J mandi inviano due 
segnali leggermente dif- 
ferenti se si preme due 
volte consecutivamente 
lo stesso tasto, questa 
tecnica viene usata per 
distinguere una pressio- 
ne lunga da due brevi. 
In molti televisori la 
pressione lunga viene 
usata per attivare i ca- 
nali dal 10 in poi. 



mo per il nostro progetto è "Universal Parallel Port"; è 
shareware, supporta l'interrupt ed è prodotto da una 
compagnia tedesca, la TheSycon Systemsoftware & Con- 
sulting GmbH. Può essere scaricato gratuitamente in 
versione demo dal sito http://www.thesycon.de così co- 
me altri driver che gestiscono, tra le altre, anche la 
porta USB. Universal Parallel Port, come quasi tutto il 
software shareware, ha delle limitazioni neir utilizzo, 
in questo caso la limitazione sta nel fatto che ogni 60 
minuti il driver smette di funzionare ed è necessario 
riavviare il sistema. 
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Fig. 3: Uno screenshot del programma dopo un 
campionamento. 

LA NOSTRA APPLICAZIONE 

Adesso che abbiamo tutto il necessario non ci resta 
che scrivere la nostra applicazione, in realtà non ci ci- 
menteremo nella scrittura di un software complesso, 
ma ne vedremo comunque gli aspetti salienti. Ricono- 
scere un tasto ha senso solo se, avvenuto il riconosci- 
mento, ne scaturisce un'azione. Nel nostro program- 
ma lasceremo questo aspetto alle vostre idee e ci oc- 
cuperemo, invece, di ricevere e visualizzare i segnali 
del telecomando a video come una sorta di oscillosco- 
pio. Ma veniamo ai dettagli dell'applicazione: una 
volta impostata l'applicazione base con il wizard di 
Microsoft Visual Studio, è stata creata una classe CPa- 
rallellO che identifica il dispositivo "porta parallela". Di 
questa classe può essere creata una sola istanza (sin- 
gleton) dinamica; essendo sia costruttore che distrut- 
tore privati, l'unico modo per creare /distruggere 
un'istanza della classe è chiamare i metodi statici Ad- 
dRef/DelRef che tengono anche un reference counter 
per distruggere l'unica istanza della classe quando 
nessun utente la sta più utilizzando. Il costruttore del- 
la classe CParallellO prova ad "aprire" il driver, attra- 
verso la funzione UppOpenDriver (l'accesso alle fun- 
zioni del driver viene garantito dal file di intestazione 
upp_api.h che si trova nella directory Source/Inc del 
driver installato sotto C:\Programmi), se l'apertura del 
driver va a buon fine prova ad inizializzare la porta 
numero 1, quella installata sulla scheda madre. Nel 
caso si voglia specificare un'altra porta, ad esempio 
una PCI o ISA installata separatamente è sufficiente 
cambiare il numero della porta nella funzione init. L'i- 
nizializzazione della porta avviene tramite la funzio- 
ne Upplnitialize, alla quale viene specificato, tramite 
una costante, anche l'intenzione di utilizzare l'inter- 
rupt. Con Universal Parallel Port l'interrupt viene ge- 



stito sincronizzando un oggetto evento con uno crea- 
to internamente dal driver e quindi creando un thread 
che rimane continuamente in attesa che questo even- 
to venga "segnalato" per poi chiamare la routine ne- 
cessaria a "gestire" l'interrupt. Segue quindi nella 
routine init il codice necessario ad ottenere questi pas- 
saggi. Bisogna dire che usare l'interrupt introduce 
una certa complessità nel progetto che ci ripagherà in 
termini di pulizia del segnale ricevuto. Si potrebbe, in- 
fatti, ricevere il segnale anche interrogando continua- 
mente la porta {polling), avendo, tuttavia, un notevole 
impatto prestazionale e, in più, con il rischio di non ri- 
levare un cambiamento di stato, nel caso in cui questo 
sia troppo rapido paragonato alla nostra velocità di 
interrogazione della porta. Questo rischio cresce in- 
sieme alla percentuale di CPU impegnata in altri com- 
piti. L'uso dell'interrupt invece garantisce un'occupa- 
zione di tempo macchina irrisoria, di fatto il PC verrà 
impegnato solo ed esclusivamente quando si riceve 
un segnale. Infine, la classe CParallellO presenta i due 
metodi EnableIRQ e DisableIRQ. EnableIRQ, come sug- 
gerisce lo stesso nome servono ad abilitare l'interrupt. 

BOOL CParallellO: :EnableIRQ(tISRfunc pISRfunc, 

void *pISRparam) 

{ 

if (iopenPortQ) return FALSE; 

// Conserva il puntatore alla funzione di callback e il 

suo parametro 
m_ISRfunc = pISRfunc; 
m_ISRparam= pISRparam; 
// Abilita il bit "IRQ enable" lasciando invariati tutti gli altri 

unsigned char value; 

ReadByte(OUTPORTl_OFS, &value); 

WriteByte(OUTPORTl_OFS, value | 

OUTPORTl_IRQENABLE); 
return TRUE; 

} 

BOOL CParallellO: :DisableIRQ() 
{ 

if (iopenPortQ) return FALSE; 

// Disabilita il bit "IRQ enable" lasciando invariati 

tutti gli altri 

unsigned char value; 

ReadByte(OUTPORTl_OFS, &value); 

WriteByte(OUTPORTl_OFS, value & 

~OUTPORTl_IRQENABLE); 

return TRUE; 

} 

Come già anticipato, per abilitare questa funzione 
della porta bisogna accedere al terzo registro della 
porta parallela ed abilitare il bit 4, in questo modo vie- 
ne segnalato all'hardware che l'interrupt è stato abili- 
tato. I parametri di EnableIRQ sono: un puntatore alla 
funzione ISR che dovrà essere chiamata ogni volta 
che viene generato un interrupt e un puntatore a void 
che contiene il parametro che verrà passato alla fun- 
zione ISR. 
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Per poter ottenere il puntatore alla funzione ISR è ne- 
cessario che questa sia un metodo statico. Dal mo- 
mento che un metodo statico non può accedere al 
puntatore this, non appartenendo ad una istanza spe- 
cifica della classe, è necessario passare tale puntatore 
come parametro, in modo che la funzione "conosca" 
la sua classe. DisabileIRQ, agisce esattamente all'oppo- 
sto della funzione EnableIRQ, disabilitando il suppor- 
to deirinterrupt. È molto importante che la funzione 
ISR sia il più breve possibile (in termini computazio- 
nali) in modo da essere eseguita molto velocemente, 
contrariamente, infatti, potrebbe verificarsi la sovrap- 
posizione di più di una chiamata a tale funzione, cau- 
sando evidenti problemi al campionamento e intro- 
ducendo la necessità di utilizzare metodi di gestione 
degli accessi ai dati tramite l'uso di oggetti di sincro- 
nizzazione come le sezioni critiche. Una volta creata la 
classe CParallellO siamo in grado gestire completa- 
mente la porta parallela, bisogna notare che per com- 
pilare il codice è necessario anche linkare al progetto 
la libreria upp_api.lib. Per avviare poi il programma bi- 
sogna copiare la DLL upp_api.dll nella stessa directory 
dell'eseguibile. Possiamo adesso creare uno strato ul- 
teriore che si occupa del campionamento dei segnali 
infrarossi attraverso l'uso di un'istanza di CParallellO; 
a tale scopo creiamo la classe CIRreceiver. CIRreceiver è 
sostanzialmente una classe contenente un buffer di in- 
teri usato per memorizzare i dati del campionamento, 
che si serve di CParallellO per gestire le operazioni di 
input/output attraverso la porta parallela. Il metodo 
responsabile del campionamento è Start Sampling. 
Chiamando questa funzione viene immediatamente 
cancellato il campionamento precedente tramite la 
funzione ClearSamples, viene attivata l'alimentazione 
del circuito accendendo il bitO (Pin 2) di uscita e quin- 
di viene attivato l'interrupt tramite il metodo Ena- 
bleIRQ di CParallellO. Analogamente StopSampling in- 
terrompe il campionamento. Questa classe mette poi a 
disposizione le funzioni per accedere al buffer dei 
campioni e due funzioni utili per l'analisi del campio- 
namento. 

La prima di queste due funzioni è GetBreakTime, una 
volta ottenuto un campionamento, questa funzione 
restituisce il valore del "break time" ovvero del valore 
più grande contenuto tra i campioni; questo valore di 
norma rappresenta la "pausa" tra un segnale ed un al- 
tro, tuttavia non sempre questo avviene, dal momen- 
to che se il tasto del telecomando viene premuto per 
un tempo troppo breve viene mandato un solo segna- 
le senza "break time" . 

La seconda funzione è CalcSignalLength, grazie alla 
quale è possibile ottenere la lunghezza del segnale an- 
che se ne è stato campionato più di uno o è stato in- 
terrotto un campionamento proprio durante un se- 
gnale. A tale scopo questa funzione esamina il cam- 
pionamento trovando prima di tutto il "break time" e 
contando quante volte si presenta tra i campioni, ta- 
glia i segnali non completi alla fine del buffer e misu- 
ra la lunghezza apparente del segnale come numero 



di campioni prima che si verifichi il break time. Infine 
verifica se, tolti i "break time", il numero di campioni 
rimanenti è divisibile per la lunghezza apparente del 
segnale. Questo metodo restituisce quindi la lunghez- 
za del segnale cercando di individuare le situazioni 
ambigue nelle quali per scarsa pulizia del segnale o 
per problemi di campionamento non è possibile rica- 
vare questo dato. Ottenere la lunghezza del segnale è 
importante nel caso in cui si voglia implementare il ri- 
conoscimento dei tasti, in questo caso, infatti, bisogna 
usare un buffer circolare lungo esattamente quanto il 
segnale e confrontare ad ogni nuovo campionamento 
con l'archivio di tasti di riferimento che precedente- 
mente si è registrato. Questo metodo è praticamente 
identico a quello usato nei videogames per il ricono- 
scimento dei cosiddetti cheats, ovvero quelle parole 
chiave che sbloccano i famosi "trucchi". È bene ricor- 
dare sempre che i confronti, così come fa la funzione 
CalcSignalLength, devono essere sempre eseguiti con 
una certa tolleranza di 1-2 millisecondi per evitare 
un'eccessiva rigidità. Nel codice sorgente potete tro- 
vare la macro EQTOLL che verifica l'uguaglianza di 
due valori considerata una data tolleranza. Per la mi- 
surazione degli intervalli di tempo è stato usato quel- 
lo che viene definito performance counter, si tratta di un 
timer ad altissima frequenza e di conseguenza di otti- 
ma precisione. La frequenza di questo timer varia a 
seconda della velocità del processore e la si può otte- 
nere tramite la funzione QueryPerformanceFrequency. 
Generalmente si hanno frequenze dell'ordine di 3 mi- 
lioni di cicli per secondo, per questo motivo la misu- 
razione dei tempi in millisecondi è da ritenere piutto- 
sto accurata. 



CONCLUSIONI 

Abbiamo, quindi, sviluppato un sistema completo, 
dall' hardware al software, per il riconoscimento di se- 
gnali dai telecomandi IR, tutto questo comincia ad 
avere un senso concreto se ad ogni tasto associamo 
poi una funzione, ancora meglio se questa funzione 
può interagire con altri programmi o parametri di si- 
stema. Ad esempio, se un nostro programma, ricevu- 
to il segnale del tasto Volume, aumenta davvero il vo- 
lume di sistema ecc. Interagire con altre applicazioni 
non è esattamente un lavoro semplice in Windows, bi- 
sogna infatti conoscere tutti i parametri della finestra 
con la quale si vuole interagire, a tale scopo, per ese- 
guire i test, può essere usato il tool Spy++ di Visual 
Studio. Infine si potrebbe anche pensare di "ritra- 
smettere", con un'altra periferica, il segnale campio- 
nato, per "comandare" il televisore o il videoregistra- 
tore dal nostro PC, in questo caso la situazione circui- 
tale si complica leggermente e bisogna avere chiari al- 
cuni concetti non immediati di elettronica e trasmis- 
sione di segnali. Spero di avere stimolato la vostra fan- 
tasia, non mi resta che salutarvi e augurarvi buona 
programmazione. 

Amedeo Margarese 
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r% Quando si lavora 
^? con le periferiche 
spesso il tempo e la ve- 
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facciamento ricoprono 
ruoli molto importanti, 
soprattutto nel caso in 
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Sistema 



File sul CD' 

\soft\codice\firefly.zip 



File sul Web W 

www.ioprogrammo.net 
/files/72/firefly.zip 



Deltapacket 

/-a Sono i pacchetti di 
^--3 dati creati dall'og- 
getto resolver in un for- 
mato xml-based che con- 
tiene tutte le informazio- 
ni necessarie per l'ag- 
giornamento della fonte 
dati. 



Sf Flash Mx e le applicazioni data-oriented. 

Firefly: i dati 
prendono il volo 



Libera la tua fantasia, con un 

kit che collega le applicazioni 

Flash a qualsiasi fonte di dati. 



E ormai fuori da ogni dubbio che Flash Mx si è 
rivelato col tempo uno strumento ideale per 
creare applicazioni dinamiche orientate ai da- 
ti. Utilizzare uno strumento come questo significa, 
per lo sviluppatore, poter creare materiale per il web 
senza dover stare a preoccuparsi dei problemi ine- 
renti ad incompatibilità tra differenti versioni di 
browser o di piattaforma, e di poter quindi garantire 
una diffusione che copre quasi 1' intero target del web 
attraverso il plugin flash player, ormai installato sul 
98% delle macchine collegate ad Internet. Inoltre è fi- 
nalmente possibile oltrepassare gli stretti vincoli che 
si incontrano nella creazione dell'interfaccia utente 
dell' applicazione, sviluppando con linguaggi che 
non permettono di dare libero sfogo alla creatività. 
Abbiamo visto in più occasioni, su questa rivista, co- 
me far interagire Flash con fonti dati esterne: 

• l'oggetto XML: è possibile integrare i dati in Flash 
con i server che usano la tecnologia XML per crea- 
re applicazioni sofisticate utilizzando i metodi del- 
l'oggetto. 



Metodo toadQ 

Metodo sendQ 
Metodo 



-XML documento 4 



> XML documento- 



= 



Documento XML 



Filmato Fiash 



Fig. 1: La comunicazione con l'oggetto XML di 
ActionScript. 

l'oggetto LoadVars: è possibile trasferire le varia- 
bili da un filmato Flash a un server e viceversa at- 
traverso l'utilizzo dell'oggetto LoadVars, che con- 
sente di inviare tutte le variabili in un oggetto a un 
URL specificato e caricare tutte le variabili di un 
URL specificato in un oggetto. 
Flash Remoting: mette a disposizione l'infrastrut- 



DATASOURCE 




PASSAGGIO DATI 
(Oggetto LoaóVars) 



Fig. 2: La comunicazione con l'oggetto 
IoadVars di ActionScript. 

tura per connettersi a servizi remoti messi a di- 
sposizione dagli application server. Questo signi- 
fica poter invocare metodi da un servizio creato 
con Coldfusion Mx, J2EE o .NET. 




Fig. 3: Funzionamento della tecnologia del 
Flash Mx Remoting. 



Con questi metodi possiamo praticamente accedere a 
qualunque fonte dati esterna, intercettare i dati dina- 
micamente, inserirli nell'interfaccia grafica per l'uten- 
te e passare i dati processati di nuovo all'oggetto re- 
moto. 

FLASH MX DATA 
CONNECTION KIT: 
FIREFLY COMPONENTS 

Nonostante in Flash Mx fosse già semplice l'accesso a 
oggetti remoti, con i Firefly components il tutto si ri- 
duce al trascinamento di oggetti già funzionanti sullo 
Stage e nella compilazione dello loro proprietà attra- 
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Fig. 4: La finestra per configurare i parametri dei 
Firefly Components. 

verso la finestra "Parametri dei Componenti'' '. I vantag- 
gi nell'utilizzo di questa suite sono molteplici: 

• Non richiedono software aggiuntivo: sviluppare con 
questa suite di components significa muoversi al- 
l'interno dell' ambiente di Flash Mx e scrivere co- 
dice Actionscript. La curva di apprendimento di 
questa nuova tecnologia è molto rapida, anche 
grazie alla ricca documentazione installata insie- 
me al pacchetto. 

• Compatibili con il flash player: dal lato utente, navi- 
gare all'interno di un'applicazione creata con i Fi- 
refly Components non comporta lo scaricamento di 
player proprietari, in quanto il file pubblicato dal- 
lo sviluppatore consiste in un swf fruibile dal 
browser attraverso il classico plugin del flash 
player. 

• Ambiente di sviluppo visuale: la configurazione dei 
componenti avviene tramite una finestra di set- 
taggio dei parametri dell'oggetto utilizzato. In 
questo modo tutte le proprietà sono modificabili 
senza inserire codice ActionScript. 

• Indipendenza dalla fonte dati: lo sviluppatore potrà 
creare la sua applicazione senza preoccuparsi di 
conoscere la tecnologia utilizzata per l'accesso alla 
fonte dati. XML, SQL Server 2000 o Flash Remo- 
ting sono tutti data sources facilmente collegabili 
agli oggetti che compongono la nostra interfaccia 
utente attraverso i Firefly components. 

• Separazioni dei contenuti dall'interfaccia utente: esse- 
re indipendenti dalla fonte dati significa poter fi- 
nalmente svincolare i contenuti dinamici della no- 
stra applicazione dall'interfaccia utente. 

I Firefly mettono a disposizione degli sviluppatori 
una architettura flessibile per accedere, editare e sal- 
vare dati provenienti da differenti data sources. L'en- 
gine lavora con i dati lato server, utilizzando tre com- 
ponenti specifici per compiere le operazioni relative al 
recupero dei dati, alla visualizzazione e al salvataggio. 
Questi oggetti sono denominati Data Access Compo- 
nents e sono rispettivamente: 

• Connector: è responsabile per il recupero dei dati 
dalla fonte dati remota. A seconda della tecnologia 
utilizzata, lo sviluppatore avrà a disposizione il re- 



lativo oggetto Connector. I dati che riceve vengono 
caricati lato client e passati al Dataset. 
Dataset: si occupa di mappare la complessa strut- 
tura dati in una più semplice configurazione for- 
mata da una struttura del tipo righe /colonne. In 
questo modo, i dati possono essere facilmente ma- 
nipolati, indicizzati, filtrati e formattati nell'inter- 
faccia utente. 

Resolver: è responsabile per il salvataggio dei da- 
ti inseriti o modificati dall'utente. Anche per que- 
st'oggetto l'utente ne ha a disposizione differenti a 
seconda della fonte dati utilizzata. Una volta che i 
dati vengono salvati, il Revolver li converte in un 
formato proprietario basato su XML e denomina- 
to Deltapackets. 



DataSouroe [ Plug-in includes j Dataset mgnag es data j Visual components allow 

l Connector fi Resolver , and tracks changes | users to vie* and edlldaia, 




Fig. 5: L'architettura dei Firefly. 

Affinché i dati vengano esposti all'utente formattati 
all'interno dell'interfaccia dell'applicazione, i Firefly 
mettono a disposizione una suite di componenti 
chiamata DataLink Components e composta da: 
FxGrid, FxCheckBox, FxComboBox, FxEditBox, FxList- 
Box, FxLookup ComboBox, FxLookup ListBox, FxMemo- 
Box, FxNavigator. Questi componenti permettono al- 
lo sviluppatore di avere a disposizione elementi di 
interfaccia pronti per l'uso e configurabili, tramite 
appositi pannelli di proprietà, capaci di formattare i 
dati passati dall'oggetto Dataset. 



UTILIZZARE I FIREFLY 

Dopo aver installato il pacchetto dei Firefly Compo- 
nents, lo sviluppatore è in grado di creare le sue ap- 
plicazioni. Aprendo Flash Mx notiamo immediamen- 
te che la palette di destra, sotto la voce Componenti, è 
stata arricchita di quattro voci : Firefly Components, Fi- 
refly Remoting, Firefly Sai, Firefly XML. Per poter me- 
glio capire dove veramente risiede la potenza e la fles- 
sibilità del pacchetto, andremo a creare un'applicazio- 
ne web che caricherà dinamicamente i dati relativi al 
catalogo corsi di una società fittizia. Una griglia mo- 
strerà le informazioni relative ai corsi disponibili, e dei 
campi testo mostreranno i prezzi e le tariffe orarie del 
corso selezionato dall'utente. Un sistema di naviga- 
zione permetterà al cliente di spostarsi all'interno dei 
dati caricati. La Fig. 7 illustra meglio di ogni altra spie- 
gazione come è formata la nostra interfaccia utente. A 
scopo puramente didattico, proveremo la nostra ap- 
plicazione caricando prima i dati da un file XML e 
successivamente mantenendo inalterata la 111 (User 
Interface), e senza scrivere una riga di codice aggiunti- 
vo, usufruiremo del Flash Remoting per connetterci 
ad un database in Access. La finalità dell'esercizio è 
quella di far notare come, cambiando semplicemente 
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Ordine dei layer 

/-£ È importante fare 
^■J attenzione nell'inse- 
rimento dei vari tipi di 
componenti nei layer. In 
particolare gli oggetti 
Connector, Dataset e Re- 
solver vanno inseriti in 
un layer sottostante a 
quello dei componenti 
per non generare errori. 
Questo perché non pos- 
sono essere visualizzati i 
dati se prima non vengo- 
no caricati. 



Componenti 
lato authoring 

/A I componenti Con- 
^J nector, Resolver e 
Dataset sono componenti 
visibili solo in lato autho- 
ring. Quando infatti an- 
diamo ad eseguire il fil- 
mato l'utente non li vi- 
sualizzerà sullo Stage. 
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Fig. 6: Il pacchetto Firefly, una volta installato, 
arricchisce di 4 voci il pannello componenti. 
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Fig. 9: Il pannello di proprietà dell'oggetto 
Connector per una fonte dati XML. 

l'oggeto compilando i campi di testo con le seguenti 
informazioni: 
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il componente "Connector" non dovremo modificare 
nulla nell'interfaccia grafica né tantomeno preoccu- 
parci di dover riformattare i dati. 
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Fig. 7: L'interfaccia utente della nostra applicazione. 

CREIAMO LA CONNESSIONE 
ALLA FONTE DATI 

Nel paragrafo precedente abbiamo detto che la fonte 
dati remota da cui caricare i dati risiede in un file XML 
(salvato col nome di corsi.xrnl) così composto: 



<?xml version = "1.0" encoding="iso-8859-l"?> 


<formazione> 


<corso id="l"> 


<codice>FLA01</codice> 


<ore>40</ore> 


< prezzo >1000</prezzo> 


< descrizione > Flash Base</descrizione> 


</corso> 
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Fig. 8: Il bottone per aprire il pannello dei 
parametri dei componenti. 

Il codice completo del file XML lo trovate nel file cor- 
so.xml nel CD-Rom allegato alla rivista. Apriamo Fla- 
sh Mx e dalla palette Componenti apriamo il menù a 
tendina e selezioniamo la voce "Firefly XML". Trasci- 
niamo sullo stage l'oggetto FxXMLConnector e dal 
pannello Proprietà clicchiamo sulla voce "Avvia il pan- 
nello dei Parametri dei componenti" . In questa finestra 
andiamo a configurare il primo tab {Properties) del- 



Source URL: contiene l'indirizzo relativo o asso- 
luto di un file XML o di un oggetto a cui accedere 
e che può ritornare informazioni in formato XML. 
Nel nostro esempio inseriamo il path relativo del 
file XML "corsi.xrnl". Il file deve risiedere nella 
stessa cartella di pubblicazione del swf. 
Document Ordered: questa proprietà ritorna un 
valore booleano (TRUE o FALSE) ed indica se il 
nostro file XML contiene record ordinati. Avere 
dati ordinati o indicizzati permette di velocizzare 
l'accesso ai dati remoti. Clicchiamo sulla check e 
rendiamola selezionata. 

Row Path: identifica il nodo di partenza da cui 
verranno caricati i dati. Si tratta di una sintassi in 
Xpath. Nel nostro esempio, per farci leggere i re- 
cord contenuti nel nodo <corso>, insieriamo la 
stringa: formazione I corso. 

Resolver: contiene il nome di istanza dell'oggetto 
Resolver se presente. Nel nostro caso non è stato in- 
serito tale oggetto. In questo caso i nostri dati so- 
no solo read-only. 

Dataset: contiene il nome di istanza dell'oggetto 
Dataset. Inseriamo il nome "data_ds" del Dataset 
che tra breve andremo ad inserire. 




Fig. IO: Il pannello di proprietà dell'oggetto 
Dataset. 



Locai Page Size: stabilisce il numero dei record 
che vengono mappati nel dataset ogni volta che 
una richiesta di ulteriori record viene eseguita. La- 
sciamo il valore di default a -1 In questo modo ri- 
sultano mappati tutti i dati nel momento in cui 
viene caricato il file xml. 
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Questo componente ha il compito di collegarsi alla 
fonte dati, ritirare i record dal file xml specificato nel 
parametro Source uri e restituire il tutto al Dataset. In- 
seriamo quindi questo oggetto sullo Stage trascinando 
la voce FxDataset dalla palette Componenti, sotto la vo- 
ce Firefly Components. Dal pannello in basso Proprietà 
settiamo il nome di istanza a: data_ds e avviamo il pan- 
nello dei Parametri del componente. Clicchiamo sul ter- 
zo tab, Fields, e creiamo le associazioni con i dati otte- 
nuti dal Connector con il tastino +. Inseriamo cinque 
nuovi field, che rappresentano i dati da inserire nella 
nostra interfaccia, e settiamo le loro proprietà. Ogni 
field ha le seguenti proprietà da settare: 



Align - allineamento del testo. 
Control - a quale componente datalink assocere- 
mo il dato. 

Default - il valore di default del dato. 
Kind - il tipo di dato ricevuto.Possiamo scegliere 
tra Data, Calculated, e Lookup. 
Label - è il nome che utilizzeremo per collegare il 
dato dinamico al componente. 
Name - il nome del componente che ci permette 
di accedere ad esso tramite Actionscript. 
Path - indica con una sintassi in Xpath il nodo da 
cui leggere il dato. 

ReadOnly - indica se il dato può essere modifica- 
to o se è di sola lettura. 

Size - proprietà applicabile ai dati di tipo stringa 
per determinare la loro lunghezza. 
Type - il formato del tipo didato ricevuto (es., 
String, Money, Date, etc). 

Width - rappresenta la larghezza del componente 
che contiene il dato. 




Fig. 11: Mappiamo 
dal tab Fields. 



i dati ricevuti dal Connector 



I fields che creeremo sono: descrizione, ore, prezzo, codi- 
ce, tariffa (è un dato di tipo calculated, cioè creato in 
runtime via codice) e settiamo le loro proprietà così 
come indicato nelle figure a lato. La parte relativa al 
caricamento dei dati in remoto è ultimata, ora rimane 
da creare l'interfaccia utente dell' applicazione. 

L'INTERFACCIA UTENTE: 
I DATALINK COMPONENTS 

Dalla palette Componenti apriamo il menu a tendina e 
selezioniamo la voce "Firefly Components" ' . Trascinia- 



mo sullo Stage i seguenti oggetti disponendoli come 
in Fig. 7: FxNavigator, FxGrid, 2 FxEditBox. Selezionado 
uno alla volta i componenti accediamo e compiliamo 
le loro proprietà dal pannello Proprietà in basso come 
segue: 

• FxNavigator: settiamo la proprietà "Dataset Na- 
me' = data_ds (nome di istanza del nostro oggetto 
Dataset). 

• FxEditBox (relativo al prezzo): settiamo la proprietà 
"Dataset Name" = data_ds e la proprietà FieldName 
= prezzo (è la label che gli abbiamo associato nel 
tab "fields" del Dataset). 

• FxEditBox (relativo alla tariffa oraria): settiamo la 
proprietà "Dataset Name" = data_ds e la proprietà 
FieldName = tariffa. 

• FxGrid (relativo al prezzo): dal tab "Properties" set- 
tiamo la proprietà "Dataset Name" = data_ds. Clic- 
chiamo sul tab "Columns" e inseriamo tre nuove 
colonne come nelle relative figure. 

A questo punto salviamo il filmato, assicuriamoci che il 
file corsixml sia presente nella cartella, copiamo dentro 
i file .surf che trovate nella cartella " [drive] :\Program- 
mi\Macromedia\Flash MX\Configuration\Firefly\Lib" 
ed eseguiamo il filmato. L'esempio completo, che si tro- 
va in allegato al CD-Rom della rivista, comprende an- 
che il codice necessario per la visualizzazione del cam- 
po (tipo Calculated) "Tariffa Oraria" che consiste in una 
divisione tra il prezzo del corso e la durata: 

getFieldByName("ta riffa"). setAsl\lumber( 
getFieldByName("prezzo").getAsl\lumber() / getFieldBy- 
Name("ore").getAsNumber() ); 

Se a questo punto volessimo cambiare la fonte dati ed 
utilizzare il Flash Remoting per accedere ad un data- 
base Access che contiene le stesse informazioni, basta 
cambiare l'oggetto FxXMLConnector con l'oggetto Fx- 
RecordsetConnector e settare le sue relative proprietà 
come neir esempio allegato (remoting_2_OK.fla). 



AD OGNUNO IL SUO LAVORO 

Ora più che mai il confine tra i compiti inerenti alla fi- 
gura del Web designer e del Web developer risulta 
marcato. Creare applicazioni orientate ai dati con Fla- 
sh Mx diventa ancora più semplice con il Data Con- 
nection Kit. Lo sviluppatore non dovrà più interessarsi 
di sapere a priori da dove provengono i dati o avere il 
terrore che durante la lavorazioni il datasource migri 
verso un'altra tecnologia. Abbiamo finalmente la cer- 
tezza che l'interfaccia grafica della nostra applicazione 
non subirà più modifiche e sarà completamente svin- 
colata dai contenuti. Flash Remoting, XML, SQL Ser- 
ver 2000 mettono la loro potenza di data management a 
disposizione della semplicità d'uso dei Firefly compo- 
nents per diventare tecnologie alla portata di tutti. 

Marco Casario 
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té Deployment ed upgrade automatico di applicazioni .NET 




licazioni 
auto-aggiornanti 



File sul CD' 

\soft\codice\ 
AutoUpgrade.zip 

File sul Web E? 

www.ioprogrammo.net/ 
files/72/AutoUpgrade.zip 



Windows 2000 

j-& A partire da Win- 
^ dows 2000, si è cer- 
cato di introdurre nuove 
soluzioni, come funzio- 
nalità Syde-by-Syde, al 
fine di attribuire ad ogni 
applicazione una propria 
versione di DLL. Tutta- 
via, prima dell'introdu- 
zione di .NET, Microsoft 
non ha proposto soluzio- 
ni significative per la ri- 
soluzione del problema. 



In questo articolo viene esposta 

una breve panoramica 

dei miglioramenti più significativi 

introdotti dal Microsoft .NET 

Framework per la fase 

di deployment e mostrato come 

sia possibile realizzare 

applicazioni .NET che effettuano 

l'upgrade "on the fly". 



Lo sviluppo di applicazioni per Windows ha sem- 
pre comportato una serie di problemi che esula- 
no dalla specificità della programmazione pura. 
Sia programmatori esperti, sia utenti finali, sono a co- 
noscenza della possibilità di trovarsi dinanzi ad appli- 
cazioni che cessano di funzionare dopo l'installazione 
di un nuovo programma. Microsoft stessa è arrivata a 
definire il fenomeno DLL Hell ovvero "L'inferno delle 
DLL" . Il problema nasceva a causa della mancanza di 
un meccanismo che tenesse traccia delle versioni di 
DLL. Spesso poteva verificarsi la spiacevole situazione 
in cui l'installazione di un programma sovrascriveva 
una determinata DLL, condivisa da più programmi, 
con una versione differente. I problemi sorgono sia nel 
caso in cui la libreria dinamica appena installata sia ob- 
soleta per alcune applicazioni condivise, sia quando la 
libreria è troppo recente e non garantisce compatibilità 
verso il basso. A partire da Windows 2000, si è cercato 
di introdurre nuove soluzioni, come funzionalità Syde- 
by-Syde, al fine di attribuire ad ogni applicazione una 
propria versione di DLL. Tuttavia, prima dell'introdu- 
zione di .NET, Microsoft non ha proposto soluzioni si- 
gnificative per la risoluzione del problema e, ad onor 
del vero, sono stati introdotti ulteriori problemi con le 
DLL COM. Purtroppo, ogni possibile soluzione non è 
sufficiente a colmare la lacuna di un'architettura priva 
di verifica delle versioni e dipendenze. 

LA RISPOSTA .NET 

Microsoft .NET Framework introduce una nuova ar- 
chitettura per lo sviluppo di Windows Forms, ovvero di 



applicazioni Windows aventi interfacce user friendly, 
integrate e interagenti col sistema operativo sottostan- 
te. Microsoft, che ha investito moltissimo su questa 
nuova tecnologia, cerca di ridurre al minimo il TCO 
(Total Cost of Ownership) delle aziende che sviluppano 
con .NET La fasi di deployment e manutenzione sono 
da sempre un ostacolo per le applicazioni Windows, e 
hanno favorito il diffondersi di applicazioni web-ba- 
sed, soprattutto in ambito distribuito. Microsoft .NET è 
una risposta efficace a questi problemi. Le applicazioni 
.NET sono costituite da blocchi logici e fisici, detti as- 
sembly. Ogni assembly è un'unità di deployment per i 
tipi e le risorse, può essere composto da uno o più file, 
e può essere sia eseguibile (.exe) sia una libreria (Ali). 
Gli assembly possono essere privati o condivisi a seconda 
del numero di applicazioni che ne dipendono. Si parla 
di assembly privato se un file eseguibile .exe necessita di 
una libreria di classi Ali che non è necessaria per il fun- 
zionamento di altre applicazioni. L'installazione di ap- 
plicazioni contenenti assembly privati, richiede una 
semplice operazione di xcopy dei file in una directory 
qualsiasi della macchina client. Questo tipo di installa- 
zione che va sotto il nome di "installazione a impatto ze- 
ro" o Xcopy Deployment non richiede la registrazione di 
alcuna chiave nel registro di Windows. Il meccanismo 
di Xcopy Deployment non prevede purtroppo la possi- 
bilità di creare icone sul desktop, nel menu Start di 
Windows o di aggiungere una entry nel panello Instal- 
lazione Applicazioni (Aggiungi/ Rimuovi programmi), così 
come di inserire la possibilità di riparare l'installazione, 
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Fig. 1: La finestra di dialogo per la creazione di un 
progetto di setup in Visual Studio .NET 2003. 
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come avviene per i software commerciali più diffusi. 
Con questo tipo di esigenze è indispensabile l'uso di 
software per la realizzazione di installazioni, o la crea- 
zione di un progetto di deployment in Visual Studio 
.NET. Nel caso di assembly condivisi da più applica- 
zioni, bisogna avere maggiore cura nel definire in ma- 
niera esatta il nome e il numero di versione, è dunque 
necessario seguire una serie di regole e convenzioni e 
solitamente vengono installati nella GAC (Global As- 
sembly Cache). Gli assembly rappresentano una brillan- 
te soluzione al DLL Hell, principalmente grazie alla lo- 
ro caratteristica di essere auto-descrittivi e di mantenere, 
all'interno del manifesto deirassembly le dipendenze 
dalla versione. Le applicazioni .NET, inoltre, vengono 
isolate attraverso il meccanismo dei domini delle applica- 
zioni garantendo Y esecuzione di più applicazioni air in- 
terno di un unico processo suddiviso in più domini. Ef- 
fettuare Tupgrade di un'applicazione, può voler dire, 
nella maggior parte dei casi, la sostituzione di alcuni fi- 
le con delle versioni più aggiornate. Un'applicazione 
che effettua il caricamento di alcuni assembly, li pone 
in uno stato di lock, che impedisce l'aggiornamento o 
la copia di nuove versioni tramite xcopy Una prima so- 
luzione a questo problema è data da un meccanismo 
detto Shadow Copying. Un piccolo eseguibile, che rima- 
ne in lock durante l'esecuzione, si occupa di creare un 
oggetto dominio di applicazione per il programma 
principale ed assegnare alla proprietà ShadowCopyFiles 
dell'oggetto AppDomainSetup il valore string "true" . In 
questo modo .NET crea una copia "shadow" dei file di 
installazione e permette operazioni di ricompilazione 
on the fly, o aggiornamento dei nuovi assembly che sa- 
ranno caricati solo al riavvio dell'applicazione stessa. 
Seguono le poche righe di codice necessarie per l'ese- 
guibile che si incarica di avviare il programma princi- 
pale: 

<CODICE VB.NET > 

Imports System 

Module Shadowlnstall 

Class Avvia 

Sub Main() 



namespace Shadowlnstall 



'crea un oggetto AppDomainSetup 



Dim ds = New AppDomainSetupQ 



'attiva la modalità Shadow Copy 



ds.ShadowCopyFiles = "true" 



'crea il dominio ed esegue l'assembly 

Programma.exe 

AppDomain.CreateDomain("EsempioShadow", 

AppDomain.CurrentDomain.Evidence,ds 
). ExecuteAssemblyCnomedirectory\Programma.exe") 

End Sub 

End Class 

End Module 

</CODICE VB.NET> 



<CODICEC#> 
using System; 



i_ 



public class Avvia 



A_ 



public static void MainQ 



A_ 



//crea un oggetto AppDomainSetup 



AppDomainSetup ds = new AppDomainSetupQ; 



//attiva la modalità Shadow Copy 



ds.ShadowCopyFiles = "true" 



//crea il dominio ed esegue l'assembly Programma.exe 
AppDomain.CreateDomain("EsempioShadow", 

AppDomain.CurrentDomain.Evidence,ds) 
.ExecuteAssemblyCnomedirectoryWProgramma.exe"); 



J_ 



1_ 



</CODICE C#> 



<CODICE J#> 



package Shadowlnstall; 



import System- 



public class Avvia 



L 



public static void mainQ 



jL 



//crea un oggetto AppDomainSetup 



AppDomainSetup ds = new AppDomainSetupQ; 
//attiva la modalità Shadow Copy 



ds.set_ShadowCopyFiles("true"); 



//crea il dominio ed esegue l'assembly Programma.exe 
AppDomain.CreateDomain("EsempioShadow", 
AppDomain.get_CurrentDomainQ.get_EvidenceQ,ds) 
■ ExecuteAssemblyCnomedirectoryWProgramma.exe"); 



} 

</CODICE J#> 



WEB BASED DEPLOYMENT 



In molte applicazioni reali viene a determinarsi l'esi- 
genza di fornire ai propri utenti una versione più ag- 
giornata del programma sviluppato. Una delle possibi- 
li soluzioni è il deployment basato sul Web. Questo ti- 
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Fig. 2: Le security policy del .NET Framework per 
l'attendibilità di un'applicazione distribuita via 
browser. 
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W Sul Web 

Seguono una serie di in- 
teressanti articoli e link 
di approfondimento. 

Simplifying Deployment 
and Solving DLL Hell 
with the .NET Fra- 
mework 

http://msdn.microsoft.com 
/library/default.asp?url = 
/library/en-us/dndotnet 
/html/dplywithnet.asp 

Deploying .NET Applica- 
tions: Lifecycle Guide 

http://msdn.microsoft.com 
/library/default.asp?url = 
/libra ry/en-us/dnbda/html 
/DALGIssues.asp 

Death of the Browser? 

http://msdn.microsoft.com 
/library/default.asp?url = 
/library/en-us/dnadvnet 
/html/vbnetl0142001.asp 

Deploying a Runtime 
Application Using Inter- 
net Explorer 

http://msdn.microsoft.com 

/library/default.asp?url = 

/library/en-us/cpguide 

/html/cpcondeployingcom- 

monlanguageruntimeap- 

plicationusingie55.asp 

.NET Framework 
Deployment Guide 

http://msdn.microsoft.com 
/library/default.asp?url = 
/library/en-us/dnnetdep 
/html/dotnetframedep- 
guid.asp 

Deploying application 

http://msdn.microsoft.com 
/library/default.asp?url = 
/library/enus/cpguide/html 
/cpcondeployingnetframe- 
workapplications.asp 
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XCopy 
Deployment 

jj» .NET introduce di- 
<-..J verse caratteristi- 
che interessanti per la 
distribuzione delle ap- 
plicazioni. Una delle più 
importanti è VXcopy De- 
ployment. 

Xcopy sta per "Extended 
Copy" ed è un comando 
MS Dos che effettua la 
copia di tutti i file e del- 
le relative sottodirec- 
tory presenti in una di- 
rectory di base. .NET ri- 
prende il termine "xco- 
py" poiché, grazie al- 
l'ausilio di un'architettu- 
ra basata su assembly 
auto-descrittivi, è possi- 
bile installare un pro- 
gramma (in managed 
code) semplicemente 
copiando tutti i file con- 
tenuti nella directory 
dell'applicazione in una 
cartella del computer di 
destinazione. Questo ti- 
po di distribuzione degli 
applicativi è anche detta 
"Installazione a impatto 
zero". 



pò di deployment prevede due possibilità, solamente 
la prima richiede l'ausilio del browser dell'utente. 
L'applicazione può essere avviata mediante Internet 
Explorer inserendo il corretto URL dell'eseguibile prin- 
cipale. .NET provvede questo tipo di deployment che 
per funzionare richiede la configurazione delle policy 
di sicurezza in modo che il codice dell'eseguibile e gli 
altri assembly correlati vengano considerati attendibili 
dal framework. Entrambe le soluzioni di distribuzione 
presentano pesanti limitazioni, ma in particolar modo 
può risultare fastidioso dover avviare un'applicazione 
tramite browser. Il secondo metodo web-based consi- 
ste nel distribuire all'utente un eseguibile dalle dimen- 
sioni ridotte ed in grado di caricare gli assembly da un 
web server specificato. Questo secondo metodo evita la 
scomodità di dover avviare il browser per eseguire il 
programma e ha un'implementazione piuttosto imme- 
diata. L'eseguibile crea e carica l'istanza della classe di 
"avvio" del programma attraverso il metodo LoadFrom 
della classe Assembly. Gli altri assembly necessari per le 
altre classi del programma saranno gestiti in maniera 
automatica dal framework. In questo modo l'applica- 
zione caricherà gli assembly sempre nella loro versione 
più aggiornata. Segue lo script necessario all'eseguibi- 
le distribuito ai client: 

<CODICE VB.NET > 

Imports asm = System. Reflection. Assembly 

Dim location As String = "http://azienda/applicazionel 
/mioprogramma.dH" CType(Activator.CreateInstance( 
asm. LoadFrom(location).GetType("ShowInstall. Avvia") 
), Windows.Forms.Form).Show() 

</CODICE VB.NET > 

<CODICEC#> 

using asm = System.Reflection.Assembly; 

string location = "http://azienda/applicazionel 

/mioprogramma.dN"; 

((Form) Activator.CreateInstance(asm.LoadFrom(location) 
.GetType("ShowInstall.Avvia"))).Show(); 



</CODICE C#> 
<CODICE J#> 



import System. Reflection.*; 



String location = "http://azienda/applicazionel 

/miopogramma.dN"; 

((Form) Activator.CreateInstance( 
Assembly. LoadFrom(location) 



■ GetType("Forms.Startup"))).Show(); 



</CODICE J#> 

I limiti di queste due tecniche sono legati alla necessità 
di essere collegati ad Internet. I programmi non po- 



tranno essere avviati se non si è connessi al web server, 
e questo può essere un grande ostacolo nell'implemen- 
tazione di soluzioni reali; inoltre i permessi concessi al- 
le applicazioni sono piuttosto ridotti rispetto alle appli- 
cazioni installate stabilmente nel sistema operativo ed 
il caricamento automatico degli aggiornamenti non è 
esteso a file che non siano assembly o file di configura- 
zione. Le soluzioni di deployment web-based sono 
adeguate nei casi in cui l'applicativo è presente in una 
Lan connessa a internet o al proprio web server, e l'ag- 
giornamento è necessario solo per file .NET, escluden- 
do quindi script, help, file xml, ecc. . .ecc. . . 



LA CLASSE AUTOUPGRADE 

Il Framework .NET non fornisce una classe o una li- 
breria che agevoli l'upgrade automatico oltre quanto 
visto sinora. Le potenzialità di .NET, tuttavia, permet- 
tono la creazione di soluzioni complesse in maniera 
ben organizzata, efficiente e rapida. Esistono diversi 
componenti, framework, librerie sviluppati in .NET, 
che rendono l'architettura di sviluppo ancora più ricca. 
Le funzionalità di aggiornamento automatico possono 
essere abilitate attraverso un'apposita classe Autollp- 
grade che viene fornita nella libreria di classi Autollp- 
grade.Lib.dll, sviluppata in VB.NET da Anthony Glenw- 
right. La classe si occupa di confrontare le versione o la 
data di ultima modifica dei file che costituiscono l'ap- 
plicazione. Ciò è possibile grazie al confronto tra il ma- 
nifesto xml dell'applicazione locale e quello reperito 
dal web server. La classe, inoltre, si occupa della gene- 
razione del manifesto e dell'upgrade nel caso in cui vi 
siano dei file sul server più recenti di quelli dell'appli- 
cazione del client. La libreria di classi e la documenta- 
zione completa in versione originale (in inglese) sono 
presenti nel CD allegato alla rivista (liberamente utiliz- 
zabili). 



AGGIORNAMENTO 

AUTOMATICO 

DELLE APPLICAZIONI 

L'inserimento di funzionalità di aggiornamento auto- 
matico, sfruttando la classe Autollpgrade, è un'opera- 



ti]! 4& 1 tt 

1^1 Solution 'Windows Application 11 1 (1 pr| 
B [jp] Windows Application 11 

*0 AutoUpgrade.Lib 

*W 5ystem 

*a System. Data 

*^ System. Drawing 

*Q System. Windows. Forrms 

*m System. XML 

B App.ico 

AssemblyInfo.es 

EU Forml.cs 

Fig. 3: Il riferimento alla libreria AutoUpgrade.Lib 
.dll nel Solution Explorer di Visual Studio .NET 2003. 



72 ►►► s 



http://www.ioprogrammo.net 



s t e m a 



zione davvero semplice e implementabile con poche 
righe di codice. Se si sta sviluppando con Visual Stu- 
dio .NET è necessario creare un riferimento alla libre- 
ria Ali nel Solution Explorer (Esplora Soluzioni) come 
mostrato in Fig. 3. 

U applicazione aggiornata andrà posta sul web server 
in una directory dalla quale saranno prelevati tutti i fi- 
le dell' applicazione. L'eseguibile principale non si oc- 
cupa del vero e proprio aggiornamento, ma determina 
se è necessario un aggiornamento o meno ed even- 
tualmente avvia un piccolo eseguibile AutolIpgrade.exe 
che si occupa di effettuare il download dei file aggior- 
nati. 

Seguono alcune righe di codice che possono essere ag- 
giunte alle applicazioni per dotarle di controllo per 
T aggiornamento : 

<CODICE VB.NET > 

Dim autoupg As AutoUpgradeQ 

Dim locationman As String = 

"http://azienda/applicazionel/miomanifesto.xmr 

autoupg = AutoUpgrade.Create(locationman) 

If Not autoupg.IsUpgradeAvailable(True) Then 

System. Windows. Forms. Application. Run(new Formi) 



Else 



'termina l'applicazione 



End If 



</CODICE VB.NET> 



<CODICEC#> 



string locationman = "http://azienda/applicazionel 

/miomanifesto.xml"; 

AutoUpgrade autoupg = AutoUpgrade.Create( 

locationman); 

if (!autoupg.IsUpgradeAvailable(true)) { 

System.Windows.Forms.Application.Run(new FormlQ); 



else{ 



//termina l'applicazione 



1_ 



</CODICE C#> 



<CODICE J#> 



String locationman = "http://azienda/applicazionel 

/miomanifesto.xml"; 

AutoUpgrade autoupg = AutoUpgrade.Create(locationman); 
if (!autoupg.IsUpgradeAvailable(true)) { 



System. Windows. Forms. Application .Run(new FormlQ); 



1_ 



else{ 



//termina l'applicazione 



1_ 



</CODICE J#> 

La classe AutoUpgrade fornisce vari overload del me- 
todo Create. Nel nostro caso Create(locationman) ottiene 
il manifesto aggiornato presente air indirizzo specifi- 
cato e crea un'istanza della classe AutoUpgrade. 
Nel caso in cui il percorso specificato non sia valido o 
non sia presente un manifesto, l'applicazione conti- 



nuerà a funzionare correttamente senza alcuna opera- 
zione di aggiornamento, poiché l'istruzione lautopg 
.IsUpgradeAvailable(true) risulterà true. Infatti, IsUpgra- 
deAvaible ha il compito di verificare se il manifesto sul 
server è più recente di quello in locale; il parametro 
(true) permette l'invocazione del metodo StartUpgrade- 
Stub per l'avvio del programma di aggiornamento. 
Se si desidera gestire in maniera manuale le operazio- 
ni di aggiornamento sfruttando i metodi di più "basso 
livello" presenti nella classe, si può porre a false tale 
parametro. Per la distribuzione sarà sufficiente inseri- 
re nella directory del client i file AutoUpgrade.exe, Auto- 
Upgrade.Lib Ali e gli assembly del programma vero e 
proprio. L'utente avvia l'applicazione, il codice prece- 
dente controlla se è presente un upgrade da effettuare, 
in caso favorevole salva il nuovo manifesto ed esegue 
AutoUpgrade.exe che effettua il download dei file ag- 
giornati dalla directory presente sul web server. Nel 
caso in cui invece non sia richiesto alcun tipo di ag- 
giornamento o l'utente non sia connesso ad internet, 
l'esecuzione del programma continuerà normalmente 
con gli assembly correntemente installati. 
Sfruttando la classe AutoUpgrade, nel file AutoUpgra- 
de.exe si potranno inserire metodi quali GenerateMani- 
fest e Save per la generazione ed il salvataggio del nuo- 
vo manifesto xml e, nel caso in cui lo si desideri, gesti- 
re individualmente le modalità di download e i sin- 
goli file per la copia dei nuovi assembly. 
Per maggiori informazioni circa la classe AutoUpgrade 
si veda la documentazione fornita dal produttore ed 
allegata nel CD della rivista. 



CONCLUSIONI 

In questo articolo abbiamo visto le novità introdotte 
dalla tecnologia Microsoft .NET per quanto concerne il 
deployment e l'aggiornamento di applicazioni on the 
fly. I vantaggi introdotti dalla possibilità di fornire ag- 
giornamenti al software preesistente sono innumere- 
voli, e in un'ottica aziendale permettono una riduzio- 
ne di costi piuttosto interessante. L'aggiornamento 
può essere inoltre utilizzato per installazioni multiple 
da un server a più client, risolvendo il caos delle ver- 
sioni eterogenee che spesso si creano a causa di ben 
noti problemi di cui abbiamo parlato all'inizio dell'ar- 
ticolo. 

In questo articolo abbiamo visto le novità introdotte 
dalla tecnologia Microsoft .NET per quanto concerne il 
deployment e l'aggiornamento di applicazioni on the 
fly. I vantaggi introdotti dalla possibilità di fornire ag- 
giornamenti al software preesistente sono innumere- 
voli, e in un'ottica aziendale permettono una riduzio- 
ne di costi piuttosto interessante. 
L'aggiornamento può essere inoltre utilizzato per in- 
stallazioni multiple da un server a più client, risolven- 
do il caos delle versioni eterogenee che spesso si crea- 
no a causa di ben noti problemi di cui abbiamo parla- 
to all'inizio dell'articolo. 

Antonio Cangiano 




Sistema 



Applicazioni 

auto-aggiornanti 



mi Bibliografia 

• MICROSOFT .NET 
PROGRAMMAZIONE 
AVANZATA 
Jeffrey Richter 




Pagine: 640 
Prezzo: € 60.00 
ISBN 88-8331-368-2 
30 aprile 2002 

Questo testo è l'ideale per 
chiunque conosca i con- 
cetti di programmazione 
object-oriented (OOP) co- 
me l'astrazione dei dati, 
l'ereditarietà, il polimorfi- 
smo. Il libro spiega detta- 
gliatamente il sistema 
estensibile dei tipi di dato 
di .NET Framework, esa- 
mina come il runtime am- 
ministra il comportamen- 
to dei tipi di dato, e analiz- 
za come un'applicazione li 
gestisce. Parlando di C#, 
presenta i concetti appli- 
cabili a tutti i linguaggi di 
programmazione che han- 
no come target .NET Fra- 
mework. 
Tra gli argomenti trattati: 

• L'architettura di .NET 
Framework 

• La costruzione, la distri- 
buzione e l'amministrazio- 
ne delle applicazioni e i lo- 
ro tipi di dato 

• La costruzione e la di- 
stribuzione delle risorse 
condivise 

• I tipi di dato fondamen- 
tali 

• Lavorare con il testo 

• Le interfacce e gli attri- 
buti 
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^Ottimizzazione dell'accesso ai dati. 

Stored Procedure con 
ADO.NET e SQL Server 



Realizzare opportune stored 

procedure può migliorare 

sensibilmente le prestazioni 

di applicazioni che accedono ai dati. 

Questo mese vedremo come 

realizzare stored procedure 

in Visual Basic usando ADO .NET 

e SQL Server. 



In questo articolo ci occuperemo di un aspetto parti- 
colarmente importante per la progettazione di da- 
tabase professionali: le stored procedure. In partico- 
lare vedremo: 

• l'utilità delle stored procedure 

• come creare stored procedure 

• diversi tipi di stored procedure 

• funzioni 

• come invocare stored procedure 
con VB/ADO .NET 



PERCHE STORED PROCEDURE 

Per capire bene l'utilità e i motivi che hanno portato al- 
l'introduzione delle stored procedure, sarà necessario 
analizzare il processo di esecuzione di una query al- 
l'interno del server di database. Nel momento in cui il 
DBMS riceve una query SQL, saranno attivate le se- 
guenti operazioni: 

• Lettura del codice SQL da parte di un parser che ne 
verifica la correttezza sintattica. 

• Controllo di contesto (context check), cioè verifica 
dell'esistenza delle entità referenziate nella query 
(tabelle, viste, attributi, ...). 

• Controllo dei diritti d'accesso dell'utente che ha in- 
viato la richiesta. 

• Ottimizazione della query. Un componente del 
DBMS, il "query optimizer", traduce la query SQL 
in un preciso algoritmo ed esegue le ottimizzazioni 
del caso. 

• Compilazione dell'algoritmo generato dal query 
optimizer in linguaggio macchina. 

• Esecuzione della query compilata. 



In molti casi, il 90% del tempo d'elaborazione si perde 
nelle fasi che precedono Y esecuzione vera e propria 
della query. Definendo la query all'interno di una sto- 
red procedure, i passi precedenti l'esecuzione sono ef- 
fettuati solo quando la procedura è memorizzata (o ag- 
giornata) per la prima volta. Le successive invocazioni 
saranno effettuate a partire dal codice precompilato nel 
linguaggio macchina nativo. Questo migliora sensibil- 
mente le prestazione del sistema. Non esiste un lin- 
guaggio standard per scrivere stored procedure. Ogni 
server di database ha il proprio ed in generale esso è 
una combinazione di istruzioni SQL con altri costrutti 
classici come IE.THEN..ELSE, FOR, WHILE, eccetera. 
E' possibile dichiarare e avvalersi dell'uso di variabili 
con relativi tipi di dato. Molti DBMS consentono anche 
di scrivere stored procedure mediante altri linguaggi di 
programmazione tipo Java SQL Embedded o C++ SQL 
Embedded. In generale un linguaggio SQL Embedded 
presenta la stessa sintassi del linguaggio originale (Ja- 
va, C++, Cobol) ma con estensioni mirate ad "incastra- 
re" istruzioni SQL all'interno del codice. Un preproces- 
sore dedicato convertirà un'applicazione SQL Embed- 
ded in un'applicazione compatibile con il compilatore 
del linguaggio originale. PL/SQL di Oracle e il T-SQL 
di Microsoft SQL Server sono esempi di linguaggi con 
i quali è possibile scrivere stored procedure. 

VISUAL STUDIO 
SERVER EXPOLER 

L'operazione di creazione di una stored procedure di- 
pende dal database sottostante. Generalmente esistono 
diversi metodi per inserire una procedura all'interno 
della struttura di un database. Molti database commer- 
ciali forniscono dei tool che, tra le tante funzionalità of- 
ferte, consentono anche la scrittura, la memorizzazione 
e l'esecuzione di stored procedure. Questi tool sono ti- 
picamente applicazioni dotate di GUI che consentono 
di creare stored procedure in modo visuale oppure 
specificando il relativo comando pseudo SQL. E' possi- 
bile inoltre, creare stored procedure e funzioni diretta- 
mente da programma. In questo paragrafo analizzere- 
mo un tool presente in Visual Studio .NET: il Server Ex- 
plorer. Questo tool consente di interagire con la strut- 
tura di un database SQL Server. Per far partire Server 
Explorer, è necessario lanciare Visual Studio .NET è se- 
lezionare la voce di menù Tools I Connect io a database .... 




.NET e DB 



Vantaggi 

r& Una stored proce- 
^J dure consiste in un 
insieme di operazioni 
memorizzate ed ese- 
guite sul server di da- 
tabase. Esse possono 
essere utilizzate per 
"spostare" parte della 
logica applicativa dal 
lato client a quello ser- 
ver. In questo modo, le 
applicazioni client ri- 
sulteranno più leggere 
e il traffico di rete sen- 
sibilmente ridotto. 
Tutto questo porterà 
un vantaggio significa- 
tivo in termini di pre- 
stazioni. Inoltre, il fat- 
to che la logica applica- 
tiva sia centralizzata 
all'interno delle stored 
procedure, renderà il 
software più facile da 
"manutenere" e riuti- 
lizzare. 
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Stored Procedure 

con ADO.NET e 
SQL Server 



Utile 

/-& La procedura pre- 
-J sentata in questa 
pagina non serve asso- 
lutamente a nulla. In- 
fatti opera sempre sul- 
lo stesso impiegato as- 
segnandogli sempre lo 
stesso numero di te- 
lefono. Se avessimo la 
possibilità di specifica- 
re la matricola dell'im- 
piegato ed il numero di 
telefono prima dell'e- 
secuzione della query, 
allora tutto il discorso 
risulterebbe certamen- 
te più utile. Natural- 
mente questa possibi- 
lità esiste e può essere 
realizzata grazie ai pa- 
rametri di input. 



Provider Connection | Advanced | Ali | 

Speaf'j the following lo corinec! to SQL Server data 

1 . Select or enter a server nanne: 

I 

2. Enter mtor ti . o the server: 

(~ UseWi iled security 

' Use a specific use: riame and iassword 
User narne: | 



TJ RefreshJ 



I 

V Blank password V Allow saving password 
3. P Select the database on the server: 

I 3 

C Attach a da atabase nanne: 

I 

Usingthe filename: 

I _l 

Test Corine::'!:: 



Help 



Fig. 1: Dialog per la connessione ad un database. 

Apparirà una dialog che chiederà a quale database vo- 
gliamo connetterci (Fig. 1). Una volta ottenuta la con- 
nessione con il database desiderato, sulla sinistra ap- 
parirà la finestra relativa al Server Explorer (Fig. 2). 




E 



% m 



]■■■ ^ Data Connections 

b- a 

E- @g Database Diagrarms 
E- Ejp Tables 
E- E^ Views 
E- f)|? 5tored Procedures 
E- Qb Functions 
^ JOEHP\Net5DK.TESTMSDE.dbo 
È- ^ Servers 



Fig. 2: Il ServerExplorer di Visual Studio. 



Da adesso in poi è possibile interagire sia con la strut- 
tura sia con i dati. Per creare una stored procedure bi- 
sogna cliccare con il tasto destro del mouse sul nodo re- 
lativo alle stored procedure e scegliere New Stored Pro- 
cedure dal pop-up menù che apparirà. A questo punto, 
nell'editor di Visual Studio .NET potrete vedere un 
template della stored procedure scritto in T-SQL (Fig. 3). 
Dopo aver scritto la procedura (vedremo in seguito nu- 
merosi esempi), sarà possibile salvarla, modificarla ed 
eseguirla; oppure effettuare altre operazioni previste 
nel pop-up menù relativo (attivabile con il tasto destro 
del mouse). Stesso discorso vale per le funzioni che so- 
no semplicemente particolari tipi di stored procedure 
che restituiscono un valore. Se avete notato, nell'albero 
di Fig. 2, è presente anche il nodo relativo alle funzio- 
ni. Il modo di operare è pressoché identico a quello vi- 



Modulel.vb | dbo. Stipendi : 5...HP\Net5DK.ORDER) dbo.StoredPro...DK.TESTMSDE)* | 


<1 > X 




CREATE PROCEDURE dbo . StouedProcedurel 


— 




/* 






( 

Gparameterl datatype = default value, 






Gparameter2 datatype OUTPUT 






*/ 






AS 






/* SET NOCOUNT ON */ 






RETURN 





sto per le stored procedure: si possono creare, salvare, 
modificare ed eseguire. Attraverso il Server Exporer 
sarà possibile anche effettuare il debugging di stored 
procedure e funzioni, proprio come avviene con il co- 
dice scritto in Visual Basic, C++ o C#. 



TIPI DI STORED PROCEDURE 

Una stored procedure può essere classificata sia in ba- 
se ai parametri che riceve in input, sia in base ai valori 
che restituisce in output. Di seguito veranno descritte 
le varie classificazioni. Le procedure senza parametri so- 
no stored procedure che effettuano un lavoro "costan- 
te" e quindi non dipendono dall'entità che le invoca. La 
procedura telefono, di seguito riportata, è un esempio di 
stored procedure senza parametri che non fa altro che 
cambiare il numero di telefono di un determinato im- 
piegato: 



ALTER PROCEDURE dbo. telefono AS 


UPDATE Impiegato 


SET telefono= 


'06/8080' 


WHERE matricola = 


'53-10642'; 




RETURN 



Molte volte c'è la necessità di scrivere procedure che re- 
stituiscono un valore. In alcuni linguaggi esiste una dif- 
ferenza sostanziale tra procedure e funzioni. Le prime 
non restituiscono nulla, le seconde devono obbligato- 
riamente restituire un valore. In T-SQL esiste questa 
differenza. Il seguente esempio crea una funzione che 
restituisce il numero complessivo di impiegati: 



CREATE FUNCTION dbo. conta 


_impiegati() 


RETURN S INTAS 


BEGIN 


declare @tot int; 


SELECT @tot = COUNT(*) FROM Impiegato; 


RETURN @tot 


END 



Fig. 3: Template di una stored procedure. 



La funzione esegue una COUNT sulla tabella Impiegato 
e inserisce il risultato nella variabile intera tot che sarà 
successivamente restituita. La funzione conta Jmpigati è 
una stored procedure a tutti gli effetti e come tale può 
essere richiamata direttamente dagli utenti del databa- 
se o dalle applicazioni che vi si connettono. Molti 
DBMS consentono di utilizzare le funzioni anche all'in- 
terno di altre istruzioni SQL o stored procedure. Nell'e- 
sempio che segue saranno selezionate tutte le aziende 
che hanno un numero di impiegati superiore a quello 
restituito dalla stored procedure conta Jmpiegati: 

SELECT * FROM Azienda 

WHERE giorni > dbo.conta_impiegati() 

Le stored procedure, siano esse funzioni o procedure, 
hanno la possibilità di accettare parametri IN, OUT e 
IN OUT. Un parametro IN è un valore che può essere 
letto e scritto dalla procedura, ma le alterazioni non sa- 
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ranno visibili all'esterno. Un parametro OUT ha la fun- 
zionalità inversa: è usato dalle stored procedure per as- 
segnare valori che saranno visibili all'esterno della pro- 
cedura. Un parametro IN OUT può essere usato indif- 
ferentemente come parametro IN o OUT. In una proce- 
dura con parametri IN, a differenza di quelle senza pa- 
rametri, l'esecuzione sarà influenzata dai valori d'in- 
gresso. Riscriviamo la procedura telefono, vista in pre- 
cedenza, specificando come parametri di input l'im- 
piegato ed il numero di telefono: 



ALTER PROCEDURE dbo 


cambia telefono 


@p_matricola char, 


@P_ 


telefono char AS 


UPDATE Impiegato 


SET telefono=@p_telefono 


WHERE matricola = 


@P_ 


matricola 


RETURN 



Adesso la procedura assume carattere generale, in altre 
parole può essere modificato il numero di telefono di 
qualsiasi impiegato. Esempi: 



cambia_telefono('53-10642' 


,'06/677788') 


cambia_telefono('53-10808' 


,'06/564343') 


cambia_telefono('53-09887' 


,'06/458214') 



L'esigenza di avere parametri OUT si ha quando una 
procedura deve restituire più di un valore. Abbiamo 
già visto che una funzione può restituire un valore. Esi- 
stono casi in cui questo può non essere sufficiente. Sup- 
poniamo di voler scrivere una procedura che restitui- 
sca il numero di impiegati che lavorano per un'azienda 
e il numero di quelli che hanno un'anzianità superiore 
ad n anni di servizio. Quello che serve in questo caso è 
una stored procedure con due parametri OUT ed uno 
IN. I parametri OUT, alla fine dell'esecuzione, conter- 
ranno rispettivamente il totale degli impiegati e quelli 
con anni di servizio superiore ad pji (che rappresenta 
il parametro IN). La procedura può essere la seguente: 

CREATE PROCEDURE dbo.servizio 

@p_totale int OUTPUT, @p_servizio int OUTPUT, @p_n int AS 



SELECT @p_totale = COUNT(*) 



FROM Impiegato; 



SELECT @p_servizio = COUNT(*) 



FROM Impiegato 



WHERE servizio >= @p_n; 



RETURN 

Come si può notare i parametri pjtotale e p_servizio so- 
no utilizzati per contenere il risultato delle due 
COUNT In alcune circostanze un parametro può esse- 
re utilizzato sia come valore d'ingresso sia come valore 
d'uscita. Supponiamo di scrivere una procedura che, 
dato un numero in input, controlla se il valore massimo 
dell'attributo servizio della tabella Impiegato è maggiore 
di questo numero. Se questa situazione si verifica, al 
numero dato in input sarà assegnato il massimo, in ca- 
so contrario non succederà nulla. Se il numero in input 
è pjnax allora alla fine dell'elaborazione esso potrà as- 



sumere o il valore del massimo tra gli attributi servizio 
oppure rimanere invariato. La stored procedure è la se- 
guente: 

CREATE PROCEDURE dbo.max_servizio 

@p_max int OUTPUT AS 

declare @tmp_max int 

SELECT @tmp_max = MAX(servizio) 

FROM Impiegato; 



if (@tmp_max>@p_max) begin 



set @p_max = @tmp_max 



end 



RETURN 

Supponiamo che l'impiegato più anziano abbia 43 an- 
ni di servizio allora: 



max 


= 35 




max 


_servizio( 


max) 


print 


max <— 


— visualizzerà 43 



max 


= 46 




max 


_servizio( 


max) 


print 


max <— 


— visualizzerà 46 



ESECUZIONE 

DI STORED PROCEDURE 

Le applicazioni Visual Basic possono eseguire stored 
procedure e funzioni attraverso l'oggetto Command di 
ADO .NET II modo di operare è molto simile a quello 
usato per invocare una query. Attraverso la proprietà 
CommandType dell'oggetto Command è possibile comu- 
nicare al provider che si intende eseguire una stored 
procedure. Il valore da assegnare alla proprietà è Com- 
mandType. StoredProcedure. L'esecuzione di procedure 
senza parametri è sicuramente il caso più semplice. E' 
sufficiente infatti specificare solo il nome della proce- 
dura nella proprietà Text dell'oggetto Command, ed il 
gioco è fatto: 

'Procedura senza parametri 

Dim command As SqlCommand = New SqlCommandQ 

command.Connection = con 

command.CommandText = "telefono" 

command.CommandType = CommandType.StoredProcedure 
command. ExecuteNonQuery() 

L'esempio eseguirà la stored procedure telefono vista in 
precedenza. L'esecuzione di una stored procedure con 
parametri IN è molto simile a quella di una query pa- 
rametrica. I parametri in ingresso dovranno essere im- 
postati attraverso l'oggetto SqlParameter, la proprietà 
Direction indicherà che i parametri sono di tipo IN tra- 
mite il valore Par umeter Direction. Input. Il seguente 
esempio invocherà la stored procedure cambia Jtelefono 
per l'impiegato 53-10642, dopo l'esecuzione il nuovo 
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Adattamenti 

In quest'articolo 
abbiamo introdot- 
to le stored procedure 
ed abbiamo visto come 
utilizzarle con ADO 
.NET, Visual Basic ed 
SQL-Server. Tenete be- 
ne in mente che tutto 
ciò che è stato detto 
può facilmente adatta- 
to al linguaggio C# op- 
pure ad un altro data- 
base quale Oracle o Sy- 
base. 



numero di telefono sarà 06-7777: 



'Procedura con parametri IN 



Dim command As SqlCommand = New SqlCommandQ 



command. Connection = con 



command.CommandText = "cambia_telefono" 

command.CommandType = CommandType.StoredProcedure 
Dim pMatricola As SqlParameter = command. Parameters. 

Add("@p_matricola", "53-10642") 

pMatricola.Direction = ParameterDirection.Input 

Dim pTelefono As SqlParameter = command. Parameters. 

Add("@p_telefono", "06/7777") 

pTelefono. Direction = ParameterDirection.Input 

command. ExecuteNonQuery() 

Come si può notare, l'oggetto Command contiene la 
proprietà Parameters che rappresenta una Collection di 
SqlParameter. Prima di invocare la procedura è necessa- 
rio aggiungere i parametri attraverso il metodo Add, 
passando il nome del parametro ed il relativo valore 
corrispondente; nel nostro caso: 

command. Parameters. Add("@p_matricola" / "53-10642") 
command. Parameters. Add("@p_telefono", "06/7777") 

A questo punto, il provider provvederà a sostituire ai 
parametri i valori opportuni prima di invocare la sto- 
red procedure. Attraverso il valore ParameterDirec- 
tion.Output della proprietà Direction è possibile comu- 
nicare che un dato parametro è di output. Nell'esempio 
che segue eseguiremo la procedura servizio, che come 
ricorderete, prevede due parametri OUT (pjotale e 
p_servizio) ed uno IN (p_n): 

Dim command As SqlCommand = New SqlCommandQ 
command. Connection = con 



command.CommandText = "servizio" 



command.CommandType = CommandType.StoredProcedure 
Dim pTotale As SqlParameter = command. Parameters. 

Add("@p_totale", SqlDbType.Int) 

pTota le .Direction = ParameterDirection.Output 

Dim pServizio As SqlParameter = command. Parameters. 

Add("@p_servizio", SqlDbType.Int) 

pServizio.Direction = ParameterDirection.Output 

Dim pN As SqlParameter =command. Parameters. Add( 

"@p_n", 10) 

pN.Direction = ParameterDirection.Input 

command .ExecuteNonQueryQ 

Console.WriteLine ("Totale Impiegati: " & retParam.Value) 
Console. WriteLine ("Con servizio superiore a " & 

pN.Value & " anni: " & pServizio. Value) 



Come si può notare, nel momento in cui si aggiunge un 
parametro di tipo OUT, è necessario anche specificarne 
il tipo. Nel nostro caso gli oggetti SqlParameter pTotale e 
pServizio saranno degli interi (SqlDbType.Int). L'esem- 
pio visualizzerà i valori assegnati ai parametri OUT 
dalla stored procedure. Essi saranno reperiti attraverso 
la proprietà value di SqlParameter. Un possibile output 



potrebbe essere il seguente: 

Totale Impiegati: 170 

Con servizio superiore a 10 anni: 83 

Per eseguire una stored procedure che prevede un pa- 
rametro IN OUT, è sufficiente impostare la properietà 
Direction di SqlParameter al valore ParameterDirection- 
InputOutput. Nell'esempio che segue sarà eseguita la 
stored procedure max_servizio, con il parametro pjnax 
di tipo IN OUT. 

'Procedure con parametri IN OUTPUT 

Dim command As SqlCommand = New SqlCommandQ 

command.Connection = con 

command.CommandText = "max_servizio" 

command.CommandType = CommandType.StoredProcedure 
Dim pMax As SqlParameter = command. Parameters. Add( 

"@p_max", 46) 

pMax.Direction = ParameterDirection.InputOutput 

command .ExecuteNonQueryQ 

Console. WriteLine("p_max: " & pMax. Value) 

Alla fine, sarà visualizzato l'eventuale nuovo valore di 

pjnax . 

ESECUZIONE DI FUNZIONI 

Come abbiamo visto, le funzioni sono un particolare ti- 
po di stored procedure che restituiscono un valore. Il 
valore di ritorno è visto da ADO .NET come un para- 
metro la cui proprietà Direction assume valore Parame- 
terDirection.ReturnValue. 

Prima di eseguire una funzione, è necessario quindi ag- 
giungere questo particolare tipo di parametro alla pro- 
prietà Parameters dell'oggetto Command. Ciò può essere 
fatto usando la funzione Add passando il nome del pa- 
rametro ed il tipo. Il seguente frammento di codice ese- 
guirà la funzione conta Jmpiegati e visualizzerà il risul- 
tato: 

'Funzione 

Dim command As SqlCommand = New SqlCommandQ 

command.Connection = con 

command.CommandText = "conta_impiegati" 

command.CommandType = CommandType.StoredProcedure 

Dim retParam As SqlParameter = 

command. Parameters. Add("ret", SqlDbType.Int) 

retParam. Direction = ParameterDirection.ReturnValue 



command .ExecuteNonQueryQ 



Console.WriteLine 



("Numero Impiegati: " & retParam. value) 

Nell'esempio è stato assegnato "ret " come il nome del 
parametro di ritorno, questo valore è totalmente arbi- 
trario e può essere scelto a discrezione dell'utente. Il 
frammento di codice visualizzerà il numero d'impiega- 
ti presenti nel sistema. 

Giuseppe Naccarato 
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tf Programmazione Enterprise (parte seconda) 

Applicazioni J2EE 
multicanale j2ee 




Accresciamo le possibilità della 

nostra rubrica aziendale con 

raggiunta dell'accesso alle 

informazioni via Web Service. 



U applicazione gestisce nativamente il canale Web ed 
il canale Wap, come è visibile in Fig. 1, ed è estensibi- 
le, nel senso che è già predisposta air erogazione degli 
stessi servizi su altri canali. L'applicazione esistente, 
dal punto di vista funzionale, implementa la comple- 
ta gestione di una rubrica aziendale, in particolare so- 
no state realizzate le funzionalità di: 



^ File sul CD 

\soft\codice\ 
mcapp_2.zip 

S? File sul Web 

www.ioprogrammo.net/ 
files/72/mcapp_2.zip 



Neil' articolo del mese scorso sono stati spiega- 
ti i concetti generali dei termini che costitui- 
scono i mattoni della multicanalità: il dispo- 
sitivo consumatore, il protocollo di erogazione ed il 
canale. È stata anche implementata una completa ap- 
plicazione multicanale attraverso l'adozione della tec- 
nologia J2EE ed utilizzando il Pattern MVC per il di- 
segno dell'architettura. Le realizzazione è stata corre- 
data di un componente Controller per il dispatching 
delle chiamate HTTP e di componenti di View e di 
Model che consentono l'erogazione del servizio attra- 
verso i canali Web e Wap. Obiettivo del presente arti- 
colo è l'estensione di questa applicazione multicanale 
con l'aggiunta dell'erogazione di servizi sotto forma 
di Web Service attraverso il protocollo applicativo 
SOAP. 



SCENARIO 

L'oggetto di partenza è l'applicazione a tre livelli rea- 
lizzata nell'articolo precedente, che abbiamo già detto 
essere stata progettata attraverso il pattern MVC e 
scritta in tecnologia J2EE. 




Fig. 1: L'applicazione multicanale completa. 



• Motore di ricerca per cognome sul database della 
rubrica. 

• Lista di tutti gli utenti compatibili con i criteri di ri- 
cerca inseriti. 

• Dettaglio completo del singolo utente selezionato. 

Estenderemo l'applicazione per rendere il motore di 
ricerca fruibile attraverso SOAP. ed utilizzeremo la 
componente Apache Axis per aggiungere alla nostra 
applicazione il canale Web Service. 

APACHE AXIS 

Axis è un SOAP Engine e consiste in un'implementa- 
zione Java della specifica SOAP. Si tratta della terza 
generazione di Apache SOAP ed è curata e rilasciata 
in modalità open source dalla Apache Software Foun- 
dation all'interno dell'ambizioso Apache XML Project. 
In questa versione Axis è stato profondamente ristrut- 
turato e mentre prima si trattava di un semplice stra- 
to software in grado di renderci trasparente l'utilizzo 
di SOAP nello sviluppo di applicazioni scritte con tec- 
nologia Java, adesso è un vero e proprio framework 
che ci permette di costruire, con estrema semplicità, 
tutto quello che ci può servire per rendere fruibili i no- 
stri servizi sotto forma di Web Service: server, client, 
proxy, stub, skeleton e gateway da e verso il protocol- 
lo SOAP. Ci troviamo di fronte, quindi, ad un ambien- 
te completo che garantisce l'interoperabilità con servi- 
zi che utilizzano tecnologie differenti, grazie al sup- 
porto completo e nativo per WSDL 1.1. Apache Axis è 
disponibile sul CD allegato, ed è disponibile per il 
download all'indirizzo: http://ws.apache.org/axis/. Per 
installare Axis sul nostro sistema è necessario scom- 
pattare il pacchetto completo xml-axis-10.zip ottenen- 
do l'alberatura di Fig. 2. A questo punto sarà necessa- 
rio copiare la directory webapps/axis all'interno della 
directory webapps del nostro application server, nel 



J2EE 

La complessa ar- 
chitettura di Java è 

divisa in tre piattaforme 

distinte. 
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Java 2 Standard Edition 
(J2SE) definisce i co- 
strutti del linguaggio, le 
librerie di utilizzo gene- 
rale ed i suoi servizi di 
base. 

Java 2 Micro Edition 
(J2ME) consente la pro- 
duzione di applicazioni 
per dispositivi wireless 
mobili e per sistemi em- 
bedded. 

Java 2 Enterprirse Edi- 
tion (J2EE) è orientata 
allo sviluppo di applica- 
zioni distribuite su siste- 
mi Internet/Intranet e 
consente la produzione 
di componenti server di 
elevata complessità at- 
traverso le tecnologie 
JSP, Servlet, EJB e Web 
Services. La piattaforma 
si completa attraverso 
l'adozione di consolidati 
standard di integrazione 
come JMS, JTS, JCA, JN- 
DI. 
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Il pattern MVC 

r& Uno degli obiettivi 
^■J del paradigma Ob- 
ject Orìented è la possi- 
bilità di realizzare classi 
che possano vivere au- 
tonomamente in qual- 
siasi contesto e non solo 
in quello nel quale ven- 
gono realizzate. 
Questo implica che le 
componenti di un'appli- 
cazione debbano essere 
sufficientemente sepa- 
rate tra loro e che pos- 
sano essere sostituite 
con altre implementate 
diversamente, a condi- 
zione che ne rispettino 
l'interfaccia. 

Per realizzare applica- 
zioni che soddisfino 
questi requisiti, si utiliz- 
za il pattern MVC che 
consente di separare tra 
loro le componenti ap- 
plicative: il Model che 
implementa le funziona- 
lità di business, la com- 
ponente di View che im- 
plementa la logica di 
presentazione ed il Con- 
troller che implementa 
la logica di controllo. 
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rendere il servizio fruibile come Web Service, dovre- 
mo creare un'interfaccia con il metodo da rendere di- 
sponibile sul canale SOAP e la classe che lo imple- 
menta. Questa struttura è visibile in Fig. 4. 



Fig. 2: L'alberatura completa di Apache Axis. 

caso specifico Tomcat 4. È necessario tener presente 
che Axis si porta dietro tutte le librerie di cui ha biso- 
gno per funzionare ad eccezione del parser XML. E' 
possibile utilizzare qualsiasi parser a condizione che 
sia compatibile con le specifiche JAXP 1.1, tradizional- 
mente si utilizza Xerces, scaricabile liberamente da 
http://xmlapache.org/dist/xerces-j/. 



ÌB»!ffl!Tg:lMJIJJ,U.hll.lJJJ.IJJJ!I.II.UJgJ,I.IHJIi1W!B^ _|p|x| 


File Modifica Visualizza Preferiti Strumenti ? 




J ^Incfetro - -► - @ E) fl | ^Cerca j*j Preferiti .JMultimedia J _> J M - g| ^ 


lenii IìH il j in I 


TJ ^vai 




zi 


Apache-AXIS 




Hrtk' 1 lì'?;rc-:>;? :■:■ Af'jii:he-A."j; 




What do you want to do ri 




• Admin 




• Vif'.v the list ■ f dirli :ved '/lirb ;irr»'n: e; 




• the 1 1 1 il i 1 1 1 1 




•: the Apache Aas HomePage 






zi 


'pei ne completata ^tjj Intranet locale 





Fig. 3: La pagina di benvenuto di Apache Axis, 
seguendo il link "validate" è possibile verificare 
l'installazione. 



Il file xerces. jar deve essere inserito nella directory 
CATALINA_HOME/webapps/axis/WEB-INF/lib. Una 
volta terminata la procedura di installazione è neces- 
sario riavviare il servizio di Tomcat e puntare il brow- 
ser all'uri: http://localhost:8080 /axis /index. html. Quello 
che si ottiene è mostrato in Fig. 3; se tutto è andato be- 
ne dovremmo aver installato correttamente Axis sul 
nostro sistema. Per verificare ulteriormente la qualità 
dell'installazione, è possibile seguire il link "Validate 
the locai installation's configuration". Se si ottiene un 
messaggio del tipo: "The core axis libraries are present." , 
siamo sicuri di avere sul nostro sistema tutto ciò che ci 
serve per realizzare e testare Web Service con Axis. A 
questo punto siamo pronti per realizzare il nostro 
Web Service. 



IL SERVIZIO 

Il nostro obiettivo è rendere fruibile, sotto forma di 
Web Service, un servizio che riceva una chiave di ri- 
cerca e ci restituisca una lista di tutti i nominativi pre- 
senti nella rubrica, il cui cognome contiene la chiave 
di ricerca stessa. Per prima cosa dobbiamo creare la 
struttura del servizio e, poiché si utilizzerà Axis per 
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Fig. 4: Class diagram dell'interfaccia del servizio e 
della sua implementazione. 

L'interfaccia è contenuta nel file SoapList.java ed ha il 
seguente contenuto: 

package com.mcapp.services; 
public interface SoapList { 

public String userl_ist(String cognome); 
} 

mentre la classe che implementa il servizio è SoapLi- 
stlmpl.java, eccone il codice: 

package com.mcapp.services; 

import java.sql.*; 

public class SoapListlmpI implements SoapList 

{ 

public String userList(String cognome) 

{ 

String output = ""; 
try 

{ 
Class. forName("sun.jdbc.odbc.JdbcOdbcDriver"); 
Connection con = DriverManager.getConnection 
("jdbc:odbc:mcapp"); 
Statement stmt = con.createStatement(); 
String qq ="SELECT id, cognome, nome, filiale 
FROM rubrica where cognome LIKE '%" 
+ cognome + "%'"; 
ResultSet rs = stmt.executeQuery(qq); 
while (rs.next()) 
{ 

for (int col = 2; 

col <= rs.getMetaData( 

).getColumnCount(); col++) 
{ 

output += rs.getString(col); 
output += ", "; 
> 

output += "\n"; 
} 
} 
catch (Exception e) 

{> 
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return output; 

J 
public static void main(String[] args) 

J 

SoapListlmpI e = new Soapl_istImpl(); 
System. out.println(c.userl_ist("a")); 
} 



> 



Si tratta, come si può vedere, di un servizio che riceve 
in input una stringa di criteri ed esegue una query su 
database ricercando tutti gli utenti censiti nella rubri- 
ca aziendale e che contengono all'interno del cogno- 
me la stringa passata come parametro. Come si può 
notare dalla dichiarazione del package, la classe e la 
sua interfaccia sono contenute, neir alberatura del- 
l' applicazione, air interno della directory src\com 
\mcapp\services. All'interno della classe che imple- 
menta il servizio è presente anche un metodo main. 
Questo si spiega in quanto, quando si scrive un servi- 
zio, è necessario testarlo localmente con dei dati di 
prova prima di renderlo disponibile all'esterno. Se 
proviamo, dall'interfaccia di Eclipse, ad eseguire il 
servizio, come visibile in Fig. 5, otterremo nella con- 
sole i due record che soddisfano il criterio che il main 
gli ha passato, possiamo pertanto affermare che il ser- 
vizio funziona e, se vogliamo, possiamo rimuovere il 
metodo main dalla classe. 




Fig. 5: Esecuzione del servizio locale 
nell'interfaccia di Eclipse. 



LA STRUTTURA 
DEL WEB SERVICE 

Per trasformare una classe che implementa un servi- 
zio in un vero e proprio Web Service, abbiamo a di- 
sposizione le funzionalità di Axis che ci consentono di 
costruire, in maniera semiautomatica, tutta l'infra- 
struttura software necessaria al nostro scopo. Per pri- 
ma cosa dobbiamo ottenere il file di descrizione del 
servizio, il file WSDL, e per averlo utilizziamo l'utility 
Java2WSDL contenuta nel package di Axis. Per fare 
questo dobbiamo recarci, nel prompt dei comandi, 
nella directory che rappresenta la root dei nostri sor- 
genti; nel nostro caso si tratta della directory C:\Pro- 
getti\mcapp\src. Da questa posizione dobbiamo ese- 



guire il seguente comando: 

java org.apache.axis.wsdl.Java2WSDL -o soaplist.wsdl - 

l"http://localhost:8080/axis/services/soaplist" -n 

urn:soaplist -p"soaplist" urn:soaplist 

com.mcapp. services. SoapList 

con il quale chiediamo al framework di generare per 
noi il file soaplist.wsdl a partire dall'interfaccia com 
.meapp. services. SoapList, per un Web Service che sarà 
disponibile agli uri ed urn indicati. Se non ci sono er- 
rori, il più tipico dei quali è dovuto alla dimenticanza 
di includere nel classpath tutti i file .jar contenuti nel- 
la directory lib di Axis, verrà generato il file soap- 
list.wsdl che descrive nei minimi dettagli il nostro ser- 
vizio web. A questo punto siamo pronti per generare, 
a partire da questo file WSDL, l'infrastruttura softwa- 
re necessaria per rendere fruibile il nostro servizio sul 
canale SOAP. L'operazione consiste nel generare nu- 
merosi file in grado di far comunicare il nostro servi- 
zio con il framework di Axis: 

SoapList.java 

SoapListService.java 

SoapListServiceLocator.java 

SoaplistSoapBindinglmpl.java 

SoaplistSoapBindingStub.java 

E la coppia di file che si occupa di configurare il de- 
ploy e l'undeploy del servizio: 

deploy.wsdd 
undeploy.wsdd 

In realtà a tutto questo pensa Axis, il nostro compito 
sarà soltanto quello di utilizzare un apposito tool pre- 
sente nel framework; penserà lui a generare il tutto. 
Rechiamoci nuovamente nella directory, che è la no- 
stra root per i sorgenti, ed utilizziamo il tool con que- 
sto comando: 

java org.apache.axis.wsdl.WSDL2Java -o . -d Session 

-s -p com.mcapp. services. ws soaplist.wsdl 

con il quale chiediamo al framework di generare, a 
partire dal file soaplist.wsdl che avevamo creato in pre- 
cedenza, tutta l'infrastruttura che software per gestire 
un servizio con scope-Session. La generazione dei file 
è immediata ed infatti troveremo nella directory 
. . ./services/ ws tutti i file che servono per gestire pub- 
blicare il servizio come Web Service. 



L'IMPLEMENTAZIONE 

Tra i vari file generati automaticamente dal tool c'è an- 
che SoaplistSoapBindinglmpl che contiene l'implemen- 
tazione di un ipotetico servizio, con le caratteristiche 
descritte nel file WSDL che abbiamo dato in pasto al 
tool. In realtà, però, ci aspetta una sorpresa; andiamo 




J2EE 



Applicazioni 

J2EE multicanale 



SOAP 

r& SOAP è un proto- 
^J collo applicativo 
che fornisce le regole 
per permettere ad appli- 
cazioni distribuite di 
scambiarsi informazioni 
e di richiedere l'esecu- 
zione di servizi remoti. 
Le applicazioni si scam- 
biano messaggi attra- 
verso un pacchetto in- 
formativo che prende il 
nome di payload, una 
struttura XML comples- 
sa. 

Non esistono restrizioni 
per quel che riguarda il 
protocollo di trasporto 
utilizzato, l'unico vincolo 
è che sia in grado di tra- 
sportare il semplice te- 
sto. 

In realtà, sebbene non 
esistano, controindicazi- 
oni di sorta verso altro 
protocolli, si tende a pri- 
vilegiare HTTP per la sua 
ampia distribuzione e 
per le caratteristiche di 
request/response simili 
a quelle di SOAP. 
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WSDL 

WSDL è una speci- 
fica del W3C 
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www.w3c.org/TR/wsdl 

che ha l'obiettivo di for- 
nire la descrizione di un 
Web Service utilizzando 
un'applicazione di XML. 
Poiché i Web Service so- 
no per definizione distri- 
buiti su piattaforme dif- 
ferenti e consumati da 
client che a priori non so- 
no noti, è bene definire 
un file WSDL per ogni 
servizio che si produce, 
in modo da disaccoppia- 
re il servizio dal client 
che cerca di utilizzarlo. 
In questo modo il client 
non utilizza direttamente 
il Web Service, ma passa 
attraverso la sua descri- 
zione in WSDL per capire 
come fare ad utilizzare il 
servizio. 



a vedere il contenuto di questo file: 



/** 

* SoaplistSoapBindinglmpl.java 

* 

* This file was auto-generated from WSDL 

* by the Apache Axis WSDL2Java emitter. 
J7 

package com.mcapp.services.ws; 

public class SoaplistSoapBindinglmpI implements 

com.mcapp. services. ws. SoapList 



{ 



public java. lang.String userList(java. lang.String inO) 
throws java.rmi.RemoteException 

J 

return nuli; 

> 



} 



Possiamo vedere che il metodo userList, cioè quello 
che viene in effetti chiamato dai client remoti via 
SOAP, restituisce sempre il valore nuli; perché? La ri- 
sposta è semplice e deriva dal processo che abbiamo 
seguito per ottenere questo file. A partire dal file di 
implementazione originale, infatti, è stato ottenuto il 
file WSDL di descrizione del servizio, che però non 
contiene informazioni riguardo l'implementazione. A 
partire da quest'ultimo poi è stato generato, tra gli al- 
tri, questo file che rappresenta l'implementazione del 
Web Service, ma il tool non ha potuto condirlo con del 
codice reale, in quanto non è a conoscenza della reale 
implementazione; infatti, ha ricevuto in input soltan- 
to la descrizione del servizio nel file WSDL. Tocca a 
noi quindi fare questa piccola parte di lavoro e modi- 
ficare il codice dell' implementazione del Web Service, 
per fare in modo che utilizzi la stessa implementazio- 
ne del servizio locale, utilizzandone di fatto un'istan- 
za. Ecco il codice modificato: 

package com.mcapp.services.ws; 

import com.mcapp. services. SoapListlmpI; 

public class SoaplistSoapBindinglmpI implements 

com.mcapp. services. ws. SoapList 

{ 

SoapListlmpI lista = new SoapListImpl(); 
public java. lang.String userList(java. lang.String inO) 

throws java.rmi.RemoteException 
{ return lista. userList(inO);} 
> 

Per prima cosa, il nuovo codice esegue l'import della 
classe che contiene l'implementazione del servizio, 
poi ne crea un'istanza e la utilizza per generare il va- 
lore che sarà restituito al chiamante. Adesso, attraver- 
so i seguenti procedimenti, il cerchio si è chiuso: 

• Costruzione di un servizio locale con tanto di test 
personalizzato. 

• Generazione del file WSDL di descrizione del ser- 



vizio attraverso il tool Java2Wsdl. 

• Generazione dell'infrastruttura software per un 
generico servizio, descrivibile con quel file di de- 
scrizione utilizzando il tool WsdUJava. 

• Personalizzazione del codice generato automati- 
camente per consentire l'utilizzo remoto dell'im- 
plementazione del servizio locale. 

Naturalmente, i file generati dai tool devono essere 
compilati, a meno di utilizzare Eclipse che compila 
automaticamente i sorgenti quando vengono salvati. 
Una vista d'insieme del progetto all'interno dell'am- 
biente di Eclipse è visibile in Fig. 6. 




Fig. 6: Vista d'insieme del progetto in Eclipse. 



A questo punto non ci resta che effettuare la pubblica- 
zione del servizio. 



IL DEPLOY 

Per fare la pubblicazione del servizio, è necessario in- 
nanzi tutto creare in file jar contenente tutti i file del 
servizio reale e dell'infrastruttura di pubblicazione. 
Per ottenere questo risultato è necessario recarsi nuo- 
vamente nella directory root dei sorgenti ed eseguire 
il comando: 

jar cfv soaplist.jar com/mcapp/services/*. class 

com/mcapp/services/ws/*. class 

Il file soaplist.jar generato, per essere visibile da Axis, 
dovrà essere collocato nella directory CATALINA_ 
HOME/webapps/axis/WEB-INF/lib. A questo punto 
possiamo far ripartire il servizio di Tomcat e, dopo es- 
serci spostati nella direrctory . . ./ 'services /ws contenen- 
te il file deploy.wsdd, possiamo effettuare il deploy at- 
traverso il comando seguente: 

java org.apache. axis. client. AdminClient deploy.wsdd 

Se non ci sono errori, il tool risponderà con il se- 
guente output: 

- Processing file deploy.wsdd 

- <Admin>Done processing</Admin> 
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ed il nostro Web Service sarà pronto a rispondere ai- 
Turi che abbiamo indicato durante la produzione del 
file WSDL. Se vogliamo verificare che il nostro Web 
Service sia stato pubblicato correttamente, all'interno 
del framework di Axis, possiamo andare all'uri http:// 
localhost:8080/axis/index.html e seguire il link "View the 
list of deployed Web services" che mostra la lista di 
tutti i servizi attualmente disponibili. In Fig. 7 viene 
mostrata la lista dei servizi nella quale, come si può 
vedere, è presente anche il nostro soaplist. 
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Fig. 7: Lista dei servizi pubblicati all'interno del 
framework Axis; è presente anche il servizio 
soaplist. 



IL CLIENT 

Adesso che abbiamo pubblicato il servizio, possiamo 
costruire un consumatore in grado di utilizzarlo. Per 
prima cosa creiamo, nelT alberatura dei nostri sorgen- 
ti, la directory src\com\mcapp\client che conterrà il 
nostro client di esempio. All'interno di questa direc- 
tory creiamo la classe SoapListTester che implementa il 
nostro client; eccone i codice: 

package com.mcapp. client; 
public class SoapListTester 

{ 

public static void main(String[] args) throws Exception 
{ 

if (args == nuli || args.length != 1) 
{ 

System. err.println("Utilizzo corretto: "); 
System. err.println("java 

com.mcapp. client. SoapListTester stringa "); 
return; 

} 

String criterio = new String(args[0]); 
com.mcapp. services. ws. SoapListService service = 
new com.mcapp. services. ws. 

SoapListServiceLocator(); 
com.mcapp. services. ws. SoapList lista = 

service. getsoaplist(); 
System. out.println("La ricerca con il criterio= 

" + criterio + " ha prodotto il seguente 
risultato:\n " + lista. userList(criterio)); } 



Come si può vedere, la chiamata al Web Service asso- 
miglia tanto ad una chiamata ad in servizio locale, in- 
fatti il client non deve far altro che istanziare il servi- 
zio attraverso l'istruzione: 

com.mcapp. services. ws. SoapListService service = 
new com.mcapp. services. ws. SoapListServiceLocator(); 

poi deve istanziare il metodo remoto attraverso l'i- 
struzione: 

com.mcapp. services. ws. SoapList lista = 

service. getsoaplist(); 

e deve eseguirlo passandogli come parametro il crite- 
rio di ricerca: 

lista. userList(criterio) 

Il risultato dell' esecuzione non è altro che il valore ri- 
tornato dall'esecuzione del metodo remoto. Questo 
dato viene infine stampato a video. Per verificare il 
funzionamento dell'applicazione di test, dobbiamo 
portarci nella posizione del file-system che rappresen- 
ta la root dei nostri sorgenti ed eseguire il comando: 

java com.mcapp. client. SoapListTester criterio 

In Fig. 8 è visibile l'utilizzo dell'applicazione di test. 




Fig. 8: Esecuzione del client in una finestra di 
command. Il consumatore utilizza il Web Service 
per mostrare i dati all'utente. 



CONCLUSIONI 

In questo articolo abbiamo esteso l'applicazione mul- 
ticanale mcapp per fare in modo che alcuni servizi po- 
tessero essere erogati anche attraverso l'utilizzo del 
canale SOAP Per raggiungere questo obiettivo è stato 
utilizzato il framework open source Apache Axis, che 
permette di concentrarsi sulla logica del servizio da 
realizzare, senza preoccuparsi troppo della semantica 
della comunicazione tra client e server attraverso il 
protocollo applicativo SOAP 

Mediante i tool messi a disposizione del framework, è 
stato generato il file WSDL di descrizione del servizio, 
a partire da questo si è generata automaticamente tut- 
ta l'infrastruttura software in grado di far comunicare 
tra loro i client consumatori con il servizio stesso. I ser- 
vizi della nostra applicazione multicanale sono eroga- 
bili, adesso, anche sotto forma di Web Service. 

Massimo Canditeci 




J2EE 



Applicazioni 

J2EE multicanale 



Apache Axis 

r& Apache Axis è l'e- 
--J voluzione di Apa- 
che SOAP 2.2, da cui 
eredita le caratteristi- 
che di base eliminando 
i difetti del predecesso- 
re: 

• È perfettamente com- 
patibile con Microsoft 
SOAP Toolkit. 

• Supporta le specifiche 
WSDL 1.1. 

Inoltre, sono previste 
le seguenti novità: 

• Supporto parziale 
delle specifiche SOAP 
1.2. 

• Supporto per la pub- 
blicazione automatica 
dei servizi (Java Web 
Service). 

• Generazione automa- 
tica (direttamente da 
un browser Internet) 
del documento WSDL 
per un servizio pubbli- 
cato. 

• Tool WSDL2Java e Ja- 
va2WSDL. 
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C o r s 



Base>*>> + >> + >*> 




Ja 



if Java per principianti. 



Un 



• If 



dil 



• li 




Questo mese facciamo il nostro terzo passo sulla 

luminosa via di Java, riprendendo il discorso da dove 

lo avevamo interrotto. Parleremo dei tipi del linguaggio, 

e in particolare di un tipo che si chiama boolean. 

Che ci spalancherà un mondo cristallino di logica, 

e ci permetterà, finalmente, di scrivere programmi un po' 

più interessanti delle solite stampe. 



File sul CD 

\soft\codice\java3.zip 

Sul CD allegato a que- 
sto numero di IoPro- 
grammo troverai un fi- 
le ZIP che contiene tut- 
to il codice degli esem- 
pi di questo mese. 



e 



ome al solito, non perdiamo tempo e stabi- 
liamo quali sono gli obiettivi per questa le- 
zione. 



File sul Web 

www.ioprogrammo.net 
/files/72/java3.zip 



Tutto 

ha un segno 

\f%\ A differenza di 
\-^\ quanto accade in 
C, in Java non esistono 
tipi numerici "senza 
segno". Sia i tipi interi 
come int che quelli in 
virgola mobile come 
doublé possono sem- 
pre rappresentare sia 
quantità positive che 
quantità negative. 



Obiettivi di questa lezione: 

• Farai la conoscenza dei tipi primitivi del linguaggio. 

• Imparerai cos'è la priorità degli operatori e come 
gestirla. 

• Farai la conoscenza del tipo boolean e degli operato- 
ri logici. 

• Incontrerai la tua prima istruzione per controllare 
la logica del programma. 



DUE TIPI DI TIPI 

Il mese scorso ho scritto che in Java esiste un numero 
infinito di tipi, perché il programmatore può creare i 
propri tipi da sé. Questa è una caratteristica della pro- 
grammazione object-oriented, della quale parleremo 
molto tra qualche mese. Per ora ci interessano solo i ti- 
pi predefiniti dal linguaggio Java, che non hanno nien- 
te a che vedere con la programmazione ad oggetti. 
Questi tipi derivano direttamente da quelli del lin- 
guaggio C, e ci permettono di definire delle semplici 
variabili come abbiamo fatto il mese scorso: 

int x; 

Questa istruzione definisce una variabile x, e specifica 
che il valore di x deve essere di tipo int. Il tipo int è il 
più comune tra i numerosi tipi interi di Java: un intero 
rappresentato in notazione a 32 bit con segno. Se non 
sai cosa significa, ti basta sapere che un int può conte- 
nere valori che vanno da -2 31 a 2 31 -1, cioè air incirca da 
meno due miliardi a più due miliardi. Se provi a met- 



tere in un int un valore più grande (o un valore non in- 
tero), aspettati un errore durante l'esecuzione del pro- 
gramma. Se vuoi manipolare numeri interi più grandi 
puoi usare un long, che con i suoi 64 bit permette di 
rappresentare numeri fino a quasi 10 miliardi di mi- 
liardi. Se invece vuoi rappresentare numeri più piccoli 
e sei particolarmente avaro di memoria puoi fare ricor- 
so al tipo byte (che appunto contiene un byte, e quindi 
un numero da -128 a +127) o al tipo short (16 bit, da 
-32768 a +32767). In realtà di solito la memoria non è 
un grande problema, e chi usa i tipi interi più piccoli lo 
fa più per comunicare le proprie intenzioni al lettore 
del codice che per risparmiare RAM. Come facciamo a 
rappresentare numeri decimali? Hai già fatto la cono- 
scenza del tipo doublé, un numero in rappresentazione 
a 64 bit in 'Virgola mobile". Questa rappresentazione è 
abbastanza precisa per la maggior parte degli scopi, a 
meno che tu non debba scrivere del software matema- 
tico o finanziario. Conviene quasi sempre usare dei 
doublé, ma se sai per certo che la variabile conterrà solo 
numeri abbastanza piccoli e con poche cifre dopo la 
virgola puoi ripiegare sul tipo float, che è più piccolo 
(virgola mobile a 32 bit). 

Un tipo un po' diverso dagli altri è char, che contiene 
un carattere Unicode. Le costanti carattere si mettono 
tra singoli apici. Ad esempio: 

char e = 'X'; 

Nota che c'è differenza tra 'X' (il carattere X) e "X" (una 
stringa contenente solo un carattere X). 

SIA DETTO 
TRA PARENTESI 

Mettiamo da parte i tipi per un po', e torniamo agli 
operatori. Secondo te, qual è l'output di questo pro- 
gramma? 
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doublé x = 3 + 2 * 6; 
System, out.println(x); 

Se hai risposto 15, magari solo perché ti sei fidato dei 
tuoi ricordi scolastici, allora complimenti: ci hai preso. 
Se hai risposto 30, allora devi fare la conoscenza di un 
concetto importante: quello di precedenza degli operatori. 
Nelle espressioni, gli operatori non vengono sempre 
valutati da sinistra verso destra come si potrebbe pen- 
sare (in questo caso il calcolo sarebbe: "3 più 2, e il ri- 
sultato moltiplicato per 6"). Esistono invece alcuni ope- 
ratori che vengono valutati prima degli altri. Ad esem- 
pio, la moltiplicazione e la divisione hanno la prece- 
denza sulla somma e la sottrazione. Quindi l'espres- 
sione del nostro esempio viene valutata come: "3 più la 
moltiplicazione di 2 per 6" '. Per cambiare la preceden- 
za nelle espressioni possiamo usare le parentesi tonde. 
Quello che è tra parentesi tonde viene valutato prima. 
Ad esempio: 

doublé x = (3 + 2) * 6; // quanto vale x? 
System, out.println(x); 

Ricorda che tutto quello che segue la doppia barra è un 
commento, e che le espressioni tra parentesi vengono 
sempre valutate prima delle altre. In questo caso l'inte- 
ra espressione viene valutata proprio come: "3 più 2, e 
il risultato moltiplicato per 6" '. Nelle espressioni più 
complicate ti capiterà di usare più livelli di parentesi 
tonde. Ti propongo un esercizio (la soluzione è verso la 
fine dell'articolo). 

Esercizio 1: Prova a indovinare l'output di questo pro- 
gramma. Poi fallo girare e verifica se il tuo calcolo era 
giusto. 




In questo codice vediamo anche un secondo modo di 
scrivere i commenti in Java. Tutto quello che si trova tra 
la sequenza di caratteri /* e la sequenza Vèun com- 
mento. A differenza del commento con "doppia barra", 
che termina sempre alla fine della riga, il commento 
con "barra e asterisco" può occupare tutte le righe che 
vogliamo. 



le variabili possono assumere solo due valori: vero 
(true) e falso (false). 
Ad esempio: 

boolean variabileLogica = true; 
boolean altravariabileLogica = false; 

Se provi ad assegnare ad una variabile booleana un 
qualsiasi valore che non sia true o false, il compilatore ti 
dà un errore. Lo stesso succede se assegni un valore 
booleano ad una variabile di qualsiasi tipo che non sia 

boolean. 



MELE E ARANCE 

Come facciamo ad ottenere un valore booleano? Il pri- 
mo modo: possiamo scriverlo come una costante (true 
o false). Il secondo modo: possiamo usare un operatore 
relazione oppure un operatore logico. Quelli relazionali e 
logici sono operatori simili agli altri, ma anziché dare 
un risultato numerico danno un risultato booleano. 
Gli operatori relazionali sono quelli che confrontano 
due espressioni (ricordati che un'espressione può esse- 
re una cosa semplice come una costante o una variabi- 
le, oppure un calcolo molto complicato). U operatore 
relazionale più semplice è quello che verifica se i valo- 
ri delle due espressioni sono uguali. Si scrive con un 
doppio segno di uguale (==) e si chiama operatore di 
uguaglianza. Ecco un esempio: 

int x = 1; 

System. out.println(x == 2); 

Questo codice stampa sullo schermo la parola "false". 
Nota che possiamo stampare un booleano esattamente 
come una stringa o come un valore numerico. Il dop- 
pio segno di uguale può sembrare una scelta strana, 
ma è indispensabile per distinguere questo operatore 
da quello di assegnamento, che si scrive come un solo 
segno di uguale. Ricorda che i due operatori sono com- 
pletamente diversi. 

L'assegnamento mette il valore dell'espressione sulla 
destra nella variabile sulla sinistra; il confronto è inve- 
ce un'espressione booleana che vale true se l'espressio- 
ne sulla destra e quella sulla sinistra sono uguali, e fal- 
se in caso contrario. 

Esercizio 2: Guarda il codice che segue. E' quasi iden- 
tico al precedente, tranne che per una piccola differen- 
za. 

int x = 1; 

System. out.println(x = 2); 




■ava 



Tutte tonde 

\/%\ A differenza di 
r^\ quanto facevamo 
sui banchi di scuola, 
nella programmazione 
non possiamo usare le 
parentesi tonde, qua- 
dre e graffe per distin- 
guere tre "livelli" di 
priorità nella valutazio- 
ne delle espressioni. Si 
usano solo le tonde, 
eventualmente con più 
livelli: 

a + (b + (e + d) + (e + f)); 

Questa espressione cal- 
cola prima (e + d) e ( e + 
f); poi somma b con (e + 
d) e con (e + f); infine 
somma a con il risultato 
dell'ultima somma. 



LA VERITÀ 

(E IL SUO CONTRARIO) 

Torniamo ai tipi. Ce ne resta solo uno, ma molto im- 
portante: il tipo boolean. Nella cosiddetta logica booleana 



Riesci a indovinare cosa stampa questo codice? 
La domanda era un po' perfida, ma magari hai indovi- 
nato da solo. Il codice che hai appena visto stampa il 
valore 2. Infatti, come per tutti gli operatori, anche ras- 
segnamento ha un valore: è il valore dell'espressione 
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Ja 



Sii bilanciato 



\/%\ Un classico errore 
r^*\ di compilazione 
che è difficile individua- 
re nel codice è quello 
che riguarda le "paren- 
tesi sbilanciate". 
Ad esempio, questa 
espressione è scritta 
male: 

a + (b + (e + d) + (e + f); 

Ciascuna parentesi che 
apri deve essere chiusa 
una ed una sola volta, 
se non vuoi far arrab- 
biare il compilatore. 



sulla destra (in questo caso la costante numerica 2). 
Quindi la seconda riga di questo codice assegna alla 
variabile x il valore 2, e subito dopo stampa il valore as- 
segnato sullo schermo. Ti spiego queste cose perché è 
abbastanza facile confondere i simboli = e ==, quindi è 
bene che tu sia preparato a riconoscere un eventuale 
errore. Un altro operatore relazionale che usa un sim- 
bolo strano è l'operatore di non uguaglianza, che si scri- 
ve con un punto esclamativo seguito da un uguale (!=). 
Questo operatore è l'inverso dell'uguaglianza, e resti- 
tuisce true solo se i due operandi sono diversi. Infine ci 
sono gli altri operatori di confronto: maggiore (>), mi- 
nore (<), maggiore o uguale (>=) e minore o uguale 
(<=). Se hai difficoltà a riconoscere la direzione delle 
freccette, usa questo trucco mnemonico: la parte "pic- 
cola" della freccia (la punta) sta sempre dalla parte del- 
l'operando più piccolo. 

LOGICA PER 

LE TUE MENINGI 

Come gli operatori relazionali, anche gli operatori logi- 
ci restituiscono sempre un valore booleano. La diffe- 
renza sta nel fatto che mentre gli operandi di un ope- 
ratore relazionale possono avere qualsiasi tipo, gli ope- 
randi di un operatore logico devono, a loro volta, esse- 
re booleani. Il più semplice operatore logico è il noi, che 
si scrive con un singolo punto esclamativo. L'operato- 
re / ha un solo operando booleano, e semplicemente ne 
inverte il valore. Se l'operando è true, il not restituisce 
false, e viceversa. Esempio: 



boolean b = 


= true; 








System. out 


println(!b); 


// stampa false 




int x = 1; 


System. out 


println(!(x 


= = 2)); // stampa 


true 


System. out 


println(x ! = 


= 2); // identica alle 


i riga 

precedente 



Un operatore logico importantissimo è Yand, che si in- 
dica con una doppia "e commerciale": &&. L'operato- 
re && prende due operandi booleani, e restituisce true 
solo se entrambi gli operandi sono true. Il suo compa- 
gno è l'operatore or, che si indica con una doppia bar- 
ra ( I \) e restituisce true solo se almeno uno tra i due 
operandi è true. Ecco un programmino che dimostra 
tutti questi operatori: 




System. out. println("x maggiore di y: " + (x > y)); 
System. out. println("x maggiore o uguale a y: " + 

(x >= y)); 



} 



} 



Nota che nelle stampe i valori booleani vengono con- 
vertiti in stringhe dall'operatore di concatenazione (+), 
proprio come succede per i valori numerici. 

Esercizio 3: Nel codice qui sopra, prova a scrivere ac- 
canto a ciascuna stampa il valore (true o false) che ne ri- 
sulterà. 

Ecco l'output del programma OperatoriBooleani: 



X = 1 


y = 2 


x uguale a y: false 


x diverso da y: true 


x minore di y: true 


x minore o uguale a y: true 


x maggiore di y: false 


x maggiore o uguale a y: false 


NOT x uguale a 1: false 


x uguale a 1 AND y uguale a 2: true 


x uguale a 1 OR y uguale a 3: true 


x uguale a 1 AND y uguale a 1: false 


x uguale a 2 OR (x uguale a 1 AND y uguale a 


1): false 



L'espressione più complicata è l'ultima. L'operatore 
&& viene eseguito per primo per via delle parentesi. 
Restituisce false, perché uno dei sue due operandi è true 
e l'altro è false. Quindi l'operatore I I restituisce false, 
perché entrambi i suoi operandi sono false. 

NELLA VITA BISOGNA 
FARE DELLE SCELTE 

Ora siamo arrivati ad un punto di svolta nel nostro cor- 
so. Finora abbiamo scritto solo programmi che fanno 
di conto e stampano i risultati sullo schermo. E' venu- 
to il momento di divertirci un po' con le prime istruzio- 
ni di controllo - quelle che fanno prendere delle decisio- 
ni al nostro codice. La più semplice e famosa è l'istru- 
zione if: 

if(condizione) 

istruzionel; 
else 

istruzione2; 

Questa istruzione dice: se (if) la condizione è vera, allora 
esegui Y istruzionel, altrimenti (else) esegui 1' 'istruzione! . 
La condizione deve essere una qualsiasi espressione 
booleana. Potrebbe essere una espressione relazionale 
complicata, oppure una semplice variabile boolean. A 
Java non importa quello che c'è tra le due parentesi 
dell' if, purché valga true oppure false. Vediamo un bloc- 
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co "if-else" in azione. Il codice che segue controlla se 
una variabile di nome numero e pari o dispari. Riesci a 
capire come funziona? 




La condizione dell' if è un'espressione che fa due cose: 

• calcola il "modulo 2" della variabile, cioè la divide 
per due e prende il resto della divisione; 

• confronta questo resto con 0. 

Per fare il confronto ho usato l'operatore di uguaglian- 
za. Se la variabile numero ha un valore pari, il resto del- 
la divisione è e tutta l'espressione vale true; se ha un 
valore dispari, il resto èie l'espressione vale false. Nel 
primo caso viene eseguita l'istruzione dopo Yif, altri- 
menti viene eseguita l'istruzione dopo Yelse. L'istruzio- 
ne else è facoltativa. Ad esempio, il codice che segue 
somma due variabili. Se la variabile somma è maggiore 
di 100 la "taglia" al valore 100, altrimenti non fa nien- 
te: 



int somma 


= primoOperando 


+ 


secondoOperando; 


if(somma > 


100) 








somma = 


100; 









Questo esercizio mette insieme diverse cose che abbia- 
mo spiegato in questo articolo: 

Esercizio 5: 

class Coffee { 
public static void main(String[] args) { 
boolean hoDelDecaffeinatoInCasa = false; 
boolean miSonoSvegliatoDaPoco = false; 
boolean hoVogliaDiBereUnCaffe = true; 
if(/* metti qui la condizione */) 

System. out.println("Bevi pure tranquillo"); 
else 
System. out.println("Meglio evitare il caffè'"); 
_} 
} 

Completa questo programma scrivendo la condizione 
dell' if. Le regole sono: se non ho voglia di caffè non ne 
bevo; altrimenti bevo solo se mi sono svegliato da po- 
co, oppure se ho del decaffeinato in casa. Per esprime- 
re queste condizioni basta un'unica espressione boo- 
leana con un and e un or. Come al solito troverai la so- 
luzione sul CD. Prova a cambiare il valore delle tre va- 
riabili booleane per vedere come cambia l'output del 
programma. Ora che hai iniziato a capire come far 
prendere delle decisioni ai tuoi programmi, non ti fer- 
merà più nessuno. L'istruzione ifè solo l'inizio. Il mese 



venturo imparerai altri modi di controllare l'esecuzio- 
ne del programma, e farai conoscenza con un altro con- 
cetto fondamentale della programmazione. Prima di 
salutarti, però, devo mantenere una promessa e darti la 
soluzione dell'Esercizio 1. 



UN'ULTIMA COSA 

doublé x = (2 + ((3 + 3)*Q+ 4))) / 2; 

Il problema era: quanto vale x? Il calcolo viene fatto co- 
me: 3 più 3, moltiplicato per 2 più 4, il tutto sommato 
con 2 e infine diviso per 2 - quindi 19. Ma dato che il 
risultato è un doublé, sullo schermo verrà stampato il 
valore decimale 19.0. 

Nota che non tutte le parentesi in questa espressione 
sono necessarie. Una regola importante è quella di usa- 
re sempre le parentesi tonde nelle espressioni non ba- 
nali, anche quando non sono indispensabili. Il compu- 
ter conosce la priorità di tutti gli operatori, ma gli esse- 
ri umani che leggono il codice potrebbero non ricor- 
darsela. Quindi è sempre meglio usare le parentesi. 

Esercizio 6: L'espressione che viene assegnata a x 
nell'Esercizio 1 contiene quattro coppie di parentesi, e 
una sola tra queste è superflua: potremmo cancellarla, 
e il risultato non cambierebbe. Riesci a identificare la 
coppia superflua? 

In questo caso non ti darò la soluzione. Per verificare se 
ci hai preso dovrai modificare il codice, ricompilarlo e 
farlo girare. Alla prossima! 

Paolo Perrotta 



Uguali dappertutto 

Quanto è grande una variabile int? Cioè: quanto 
spazio occupa un int in memoria? In molti lin- 
guaggi, come ad esempio in C e in C++, la rispo- 
sta cambia da un computer all'altro. Questo per- 
ché a seconda del computer su cui compiliamo, e 
quindi del compilatore che usiamo, una variabile 
intera in C può occupare più o meno spazio. Que- 
sto significa che il tipo int può contenere dei nu- 
meri più grandi su una certa macchina di quanto 
non ne contenga su un'altra. Lo stesso vale per 
gli altri tipi, come long e doublé. Nel caso delle 
variabili in virgola mobile, le dimensioni in me- 
moria del tipo ne influenzano non solo la "capien- 
za", ma anche la precisione (il numero di cifre si- 
gnificative). 

È chiaro che in queste condizioni i programmi non 
possono girare nello stesso modo su tutte le mac- 
chine, nemmeno se li ricompiliamo. Ad esempio: 
un programma che fa calcoli matematici può usa- 
re tranquillamente un float per contenere una ci- 
fra su una macchina, mentre su un'altra macchi- 
na questo tipo è insufficiente a darci la precisio- 
ne che vogliamo. Per risolvere questo problema, 
Java ha rimosso del tutto questa ambiguità. Non 
importa quale sia il microprocessore, la macchina 
virtuale Java memorizza le variabili sempre nello 
stesso modo. Ad esempio, un int in Java è sempre 
lungo quattro byte. 




ava 



Geroglifici 



\/%\ Operatori come 
1^1 1 1, && oppure ! 
potrebbero sembrarti 
difficili da memorizza- 
re e distinguere. Per- 
ché scrivere "&&" an- 
ziché semplicemente 
"and"? Purtroppo Java 
ha preso buona parte 
della sua sintassi dal 
linguaggio C, e questo 
spiega perché alcuni 
operatori abbiano no- 
mi così oscuri. Ma non 
preoccuparti. Anche se 
all'inizio ti sarà facile 
confonderti, non ci so- 
no molte parti del lin- 
guaggio che ti richie- 
dono di memorizzare 
simboli astrusi - quindi 
ti basterà un po' di 
esperienza per memo- 
rizzare perfettamente i 
pochi nei quali ti im- 
batterai. 
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Visual Basic 

.NET 
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Ó Immettere informazioni con caselle e pulsanti. 

Controllo 
dell'input utente 

Come impedire all'utente distratto di scrivere 
dati errati. 



File sul CD 



\soft\codice\Controlli.zip 



File sul Web 

www.ioprogrammo.net 
/files/72/controlli.zip 



Click 

e DbICIick 




\r%\ *' c H ck del mouse 
\^-^\ su un controllo, è 
una metafora molto 
intuitiva di un'azione 
che tutti eseguono fre- 
quentemente. L'evento 
DbICIick si verifica 
quando l'utente fa dop- 
pio click sul controllo, 
per convenzione viene 
usato quando si vuole 
velocizzare un'opera- 
zione, facendo com- 
piere all'utente con- 
temporaneamente, l'a- 
zione di scelta e quella 
di conferma. 
È importante sapere 
che se l'utente fa dop- 
pio click su un control- 
lo, viene eseguito pri- 
ma il codice dell'evento 
Click e poi quello del- 
l'evento DbICIick. 




Uno dei maggiori problemi nello sviluppo di 
applicazioni per Y acquisizione di dati, è 
sempre stato quello di impedire all'utente di 
introdurre informazioni errate (ad esempio per erro- 
ri di battitura). In questo articolo scopriamo quali 
sono gli accorgimenti da adottare per prevenire pos- 
sibili inconvenienti. Una soluzione, laddove i possi- 
bili dati da inserire siano in numero limitato, può 
essere quella di sostituire il TextBox di input con un 
elenco di opzioni selezionabili con il mouse. In que- 
sto articolo descriveremo i controlli CheckBox e 
RadioButton che permettono di "presentare" opzioni 
di scelta ad un utente distratto, il controllo Button che 
permette di confermare una scelta e di compiere 
un'azione ed i controlli contenitore GroupBox e Panel. 



METODI COMUNI 

Prima di passare alla descrizione dei controlli in 
esame analizziamo alcuni dei metodi comuni a tutti i 
controlli, divisi per categoria. 

Dimensioni e posizione 

Quando si crea un'interfaccia utente complessa con 
molti controlli contenitore (oppure si utilizzano più 
form in un'interfaccia a documenti multipli), può 
essere necessario disporre tali controlli su più livelli 
(lo stesso dicasi per le form figlie). Per spostare e tene- 
re traccia dei controlli è necessario modificare Yordine 
Z. Si definisce ordine Z la disposizione visiva dei con- 
trolli su più livelli all'interno di una form, lungo l'as- 
se z della stesso form (profondità). I metodi che con- 
sentono di modificare l'ordine Z dei controlli, sono 
BringToFront e SendToBack. 

• BringToFront: permette di spostare il controllo in 
primo piano nell'ordine z. Se il controllo è figlio di 
un altro controllo, anche il controllo figlio viene 
spostato in primo piano nell'ordine z. 

• SendToBack permette di spostare il controllo in 



secondo piano nell'ordine z. Se il controllo è figlio 
di un altro controllo, anche il controllo figlio viene 
spostato in secondo piano nell'ordine z. 

• FindForm: permette di referenziare la form in cui 
si trova il controllo. 

Aspetto 

• Show: consente di rendere visibile il controllo 
all'utente.Mostrare il controllo equivale ad impo- 
stare la proprietà Visible a true. Dopo avere chia- 
mato il metodo Show, la proprietà Visible restitui- 
sce un valore true fino a quando non viene chia- 
mato il metodo Hide. 

• Hide: consente di nascondere il controllo all'uten- 
te. Nascondere il controllo equivale ad impostare 
la proprietà Visible a false. Dopo avere chiamato il 
metodo Hide, la proprietà Visible restituisce valore 
false fino a quando non viene chiamato il metodo 
Show. 

• Invalidate: consente di invalidare un'area specifi- 
ca del controllo, determinando l'invio di un mes- 
saggio di disegno al controllo. 

• Refresh: determina l'invalidazione dell'area 
client del controllo ed il nuovo disegno di que- 
st'ultimo e degli eventuali controlli figlio. 

Focus 

• Focus: consente di impostare lo stato attivo per 
l'input del controllo. Alcuni controlli Windows 



"Giorni — 
C Lunedi 
C Martedì 
(* Mercoledì 
C Giovedì 
C Venerdì 
C Sabato 
f Domenica 



"Fenomeni Atmosferici — 
W Sole r Neve 

W Pioggia W Vento 



, unedi: Sole Neve 
Martedì: Sole Pioggia 
Mercoledì: Sole Pioggia Vento 
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Fig. 1: Esempio di un form con più controlli 
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Form non possono ricevere il focus, così come i 
controlli da essi derivati. Tali controlli sono: Panel, 
GroupBox, PictureBox, ProgressBar, Splitter, Label e 
LinkLabel quando nel controllo non è presente 
alcun collegamento. 
• GetNextControl: consente di referenziare il con- 
trollo successivo in avanti o all'indietro nell'ordi- 
ne di tabulazione dei controlli figlio. 

IL CONTROLLO BUTTON 

La metafora del pulsante è certamente la metafora 
più usata in VB, in linea di principio un pulsante è 
un'area dello schermo che l'utente può selezionare 
con un clic del mouse. Un pulsante è rappresentato, 
in VB.NET, dal controllo Button. Il controllo Button 
presenta generalmente una didascalia (ad esempio 
Ok, Annulla) ed, in particolari occasioni, un'immagine 
che fa comprendere immediatamente all'utente l'a- 
zione generata nel momento in cui verrà premuto il 
pulsante. Per modificare la descrizione del pulsante si 
deve usare la proprietà Text . 

Dopo aver posizionato il pulsante sulla form si deve 
scrivere il codice adeguato all'azione che dovrà com- 
piere, tale codice viene scritto solitamente nell'evento 
Click: 

Private Sub Button l_Click(ByVal sender As 

System. Object, ByVal e As System. EventArgs) 
Handles Buttonl.Click 
'inserire qui il codice di risposta all'evento 
End Sub 

Per inserire un'immagine nel pulsante si deve utiliz- 
zare la proprietà Image. È sufficiente cliccare sulla pro- 
prietà Image, nella finestra delle proprietà, e selezio- 
nare un'immagine dalla finestra di dialogo (è inoltre 
possibile usare il controllo ImageList che vedremo nei 
prossimi articoli). Per definire un pulsante come pul- 
sante di default, si deve impostare la proprietà 
AcceptButton, della form che lo contiene, selezionan- 
do il pulsante dall'elenco a discesa. Premendo il tasto 
INVIO da un qualsiasi punto della finestra, il control- 
lo passa al pulsante definito come pulsante di default 
attivandone l'evento Click. 

Si deve prestare particolare attenzione a definire un 
pulsante come pulsante di default, poiché l'utente 
può essere portato ad usare il tasto INVIO per passa- 
re da un campo ad un altro, attivando il pulsante 
senza rendersene conto. Se il pulsante deve compiere 
un'operazione potenzialmente dannosa per l'applica- 
zione (ad esempio chiudere una finestra, senza salva- 
re i dati) è sempre auspicabile visualizzare un mes- 
saggio d'avviso per poter, eventualmente, annullare 
l'operazione. 

Impostando la proprietà CancelButton della form, il 
pulsante selezionato verrà attivato quando viene pre- 
muto il tasto ESC (il tipico caso di un pulsante 
Annulla). 



CHECKBOX 

Il controllo CheckBox (casella di controllo) è rappre- 
sentato graficamente da un'etichetta con a fianco una 
casella. Quando il controllo viene selezionato, nella 
casella viene visualizzato un segno di spunta. Solita- 
mente è utilizzato per visualizzare risposte a scelta 
multipla o per visualizzare una serie di opzioni tra 
cui selezionare quelle desiderate. Ogni volta che si 
clicca sul controllo, si alternano i valori Prue e False. Le 
proprietà più utilizzate sono: 

• La proprietà CheckAlign usata per variare la posi- 
zione della casella di selezione all'interno del con- 
trollo, consente di scegliere tra nove diversi valo- 
ri. La proprietà CheckAlign, generalmente, è utiliz- 
zata congiuntamente alla proprietà PextAlign per- 
mettendo di disegnare il controllo in molti modi 
differenti. 

• La proprietà Checked (non è più presente la pro- 
prietà Value) viene usata per impostare o testare 
se il controllo è stato selezionato. Può essere im- 
postata a: 

1) False per indicare che il controllo non è sele- 
zionato. 

2) Prue per indicare che il controllo si trova nello 
stato di selezionato. 

L'evento generalmente più utilizzato è l'evento Click, 
che si verifica quando si modifica lo stato del control- 
lo. Generalmente in quest'evento viene scritto il codi- 
ce necessario per abilitare o disabilitare altri controlli 
in dipendenza della scelta effettuata. Simuliamo, ad 
esempio, di essere in presenza di due possibilità di 
scelta autoescludenti. Selezionando un CheckBox 
automaticamente si deve deselezionare l'altro, per 
questo nell'evento Click dei due CheckBox dovremo 
scrivere: 

Private Sub CheckBoxl_Click(ByVal sender As Object, 
ByVal e As System .EventArgs) Handles CheckBoxl.Click 
'se Checkboxl viene selezionato allora Checkbox2 
'deve essere deselezionato 
If CheckBoxl .Checked = True Then 

CheckBox2.Checked = False 
End If 
End Sub 

Private Sub CheckBox2_Click(ByVal sender As Object, 
ByVal e As System .EventArgs) Handles CheckBox2.Click 
If CheckBox2.Checked = True Then 

CheckBoxl .Checked = False 
End If 
End Sub 



RADIOBUTTON 

Il controllo RadioButton (Pulsante di opzione) si com- 
porta in modo simile al CheckBox, con la sola diffe- 
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MouseDown, 
Mousellp, 
MouseMove, 
MouseWheel 



a; 



Nella maggior 
| parte dei casi, 
gli eventi Click e 
DbICIick saranno più 
che sufficienti per la 
gestione del mouse, 
ma in alcune applica- 
zioni potrà essere 
necessario distingue- 
re il click sinistro da 
quello destro, oppure 
la pressione dei tasti 
Ctrl, Shlft e Alt con- 
temporaneamen te al 
pulsante del mouse 
(la metafora della 
multiselezione), per- 
ciò si rende necessa- 
rio l'uso degli eventi 
MouseDown, Mouse- 
Up e MouseMove. 
L'evento MouseDown 
viene generato quan- 
do viene premuto il 
pulsante del mouse 
(sia il sinistro sia il 
destro), quando il 
pulsante viene rila- 
sciato viene generato 
l'evento MouseUp, e 
quando il mouse si 
sposta su un control- 
lo viene generato Te- 
vento MouseMove. Il 
nuovo evento Mouse- 
Wheel viene generato 
quando si utilizza la 
rotella del mouse. 
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Eventi 
del mouse 



\/%\ Questi eventi ri- 
l^^l cevono le infor- 
mazioni riguardanti lo 
stato del mouse in un 
oggetto MouseEvent- 
Args che espone le 
seguenti proprietà: 

• Button restituisce il 
valore (indicato sotto 
forma di un valore enu- 
merato MouseButtons) 
che indica quale pul- 
sante del mouse è 
stato premuto o rila- 
sciato. Il tipo enumera- 
to MouseButtons ge- 
stisce i cinque pulsanti 
del mouse sotto Win- 
dows 2000 e XP. 

• X e Y restituiscono le 
coordinate X ed Y (ri- 
spetto all'angolo supe- 
riore sinistro) della po- 
sizione corrente del 
puntatore del mouse 
espresse in pixel. 

• Clicks restituisce il 
numero di volte che il 
pulsante del mouse è 
stato premuto e rila- 
sciato. 

• Delta restituisce il 
numero di giri della 
rotellina del mouse. Un 
valore positivo indica 
che la rotella è stata 
ruotata in avanti, men- 
tre un valore negativo 
indica che la rotella è 
stata ruotata ali 'indie- 
tro. 
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Fig. 2: Il controllo GroupBox in azione. 



renza che in un gruppo di controlli RadioButton è 
possibile selezionare un solo controllo alla volta, 
mentre è possibile selezionare più controlli CheckBox 
contemporaneamente. Anche per i controlli Radio- 
Button le proprietà più utilizzate sono le proprietà 
CheckAlign e Checked il cui comportamento è identico 
a quello delle proprietà del CheckBox. Solitamente i 
controlli RadioButton logicamente legati tra di loro, 
sono raggruppati in un controllo contenitore, tipica- 
mente un controllo GroupBox. Tutti i controlli Radio- 
Button, non raggruppati, presenti in una Form, appar- 
tengono allo stesso gruppo, di conseguenza sarà pos- 
sibile selezionarne soltanto uno per volta (anche se, a 
parte il fatto di apparire sulla stessa form, non hanno 
nulla in comune). 

MOSTRARE RADIOBUTTON E 
CHECKBOX COME PULSANTI 

I controlli RadioButton ed i controlli CheckBox possono 
essere visualizzati con la veste grafica dei pulsanti per 
rendere Y interfaccia più accattivante. Si possono vi- 
sualizzare delle icone in modo che i controlli abbiano 
T aspetto grafico di un pulsante ed il comportamento 
dei relativi controlli: cliccando su un pulsante esso 
rimane nello stato di premuto (ad indicare che il pul- 
sante è stato selezionato) fino a quando non si clicca 
di nuovo sul pulsante per passare allo stato di non 
premuto (ad indicare che il pulsante non è seleziona- 
to). Nel caso di più pulsanti RadioButton soltanto uno 
di essi resta nello stato di premuto. Si deve porre par- 
ticolare attenzione a non confondere l'utente poiché i 
controlli RadioButton e CheckBox in modalità pulsanti 
sono uguali ai normali Button, si deve perciò rendere 
chiaro il diverso funzionamento dei controlli (per 
esempio raggruppandoli in un GroupBox la cui eti- 
chetta ne specifichi il funzionamento). Le proprietà 
da utilizzare sono: 

• Appearance: deve essere impostata a Button. 

• Image: definisce l'immagine che dovrà essere vi- 
sualizzata sul RadioButton o sul CheckBox. 



IL CONTROLLO GROUPBOX 

Il controllo GroupBox permette di raggruppare con- 
trolli comportandosi come un contenitore di controlli 
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logicamente legati fra loro, (prende il posto del con- 
trollo Frante presente in VB6). Generalmente il Group- 
Box viene utilizzato soltanto per raggruppare dei 
controlli, perciò non vengono gestiti i suoi eventi, e 
vengono solitamente modificate poche proprietà: le 
proprietà Name, Text e FlatStyle. A differenza del con- 
trollo Frante non è possibile disegnare un GroupBox 
senza bordi. I controlli figli devono essere creati sele- 
zionando r icona corrispondente dalla casella degli 
strumenti, e disegnando il controllo all'interno dell'a- 
rea del GroupBox. 

È possibile selezionare un controllo già esistente e tra- 
scinarlo sul GroupBox. Il controllo GroupBox presenta 
alcune caratteristiche interessanti dei controlli conte- 
nitori (il principale controllo contenitore è la form): 

• Se si sposta un controllo GroupBox vengono spo- 
stati anche i controlli che contiene; 

• Se si disabilita o si rende invisibile il GroupBox si 
disabiliteranno o si renderanno invisibili tutti i 
controlli contenuti in esso; 

• Non è possibile spostare un controllo figlio fuori 
dai limiti del GroupBox. 

Nei controlli contenitore è possibile utilizzare il meto- 
do Scale per spostare e ridimensionare uno o più con- 
trolli. L'effetto del metodo Scale è di modificare le 
dimensioni di un controllo in base ad un fattore di 
scala specificato (è possibile specificare due fattori 
distinti per gli assi X e Y). La caratteristica più impor- 
tante di questo metodo è che la trasformazione viene 
applicata a tutti i controlli contenuti nel GroupBox. Se 
un controllo contenuto nel GroupBox è anch'esso un 
contenitore, le modifiche vengono applicate anche ai 
relativi controlli figli e così via in modo ricorsivo 
(pensate a cosa può succedere se si applica il metodo 
ad una form). 



IL CONTROLLO PANEL 

Il controllo Panel assomiglia al controllo GroupBox, ed 
è anch'esso un contenitore per altri controlli. A diffe- 
renza del GroupBox non ha il bordo visibile e non ha 
un'etichetta (non è quindi disponibile la proprietà 
Text) mentre è in grado di gestire la proprietà 
AutoScroll e tutte le proprietà ad essa correlate (in 
modo che l'utente finale possa scorrerne il contenu- 
to). È inoltre possibile ancorare o controllare la di- 
stanza dal bordo dei controlli in esso contenuto, tra- 
mite la proprietà DockPadding 

APPLICAZIONE 
DI ESEMPIO 

Per meglio fissare i concetti espressi finora realizzia- 
mo una semplice applicazione che mostri un prospet- 
to riassuntivo delle condizioni meteorologiche verifi- 
catesi durante la settimana. Per il nostro scopo avre- 
mo bisogno di: 
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• 7 RadioButton che rappresentino i giorni della 
settimana, con i seguenti nomi: RadioButtonLu- 
nedi, RadioButtonMartedi, RadioButtonMercoledi, 
RadioButtonGiovedi, RadioButtonVenerdi, Radio- 
ButtonSabato, RadioButtonDomenica; 

• 4 CheckBox che rappresentino le condizioni 
atmosferiche, con i seguenti nomi: CheckBoxSole, 
CheckBoxPioggia, CheckBoxNeve, CheckBoxVento; 

• 2 GroupBox che raggruppino i RadioButton ed i 
CheckBox; 

• 1 Button per confermare la condizione atmosfe- 
rica verificatasi, dal nome ButtonConferma; 

• 1 TextBox multiriga che visualizzi il prospetto 
riassuntivo, dal nome TextBoxRiepilogo. 

Il codice necessario dovrà essere scritto nell'evento 
Click di ButtonConferma: 

Private Sub ButtonConferma_Click(ByVal sender 

As System. Object, ByVal e As System. EventArgs) 
Handles ButtonConferma. Click 

Dim Giorno As String 

Dim Tempo As String 

Giorno = DeterminaGiorno() 

Tempo = DeterminaTempo() 

TextBoxRiepilogo. Text = TextBoxRiepilogo. Text + 

vbCrLf + Giorno + Tempo 

End Sub 

Sono state dichiarate due variabili, Giorno e Tempo, 
di tipo stringa. Alle due variabili si assegna il valo- 
re di ritorno delle due funzioni DeterminaGiorno e 
DeterminaTempo che si faranno carico di comporre la 
stringa risultato in base alle scelte dell'utente. 
Infine nel TextBox di riepilogo si mostrano le infor- 
mazioni su ogni singola riga separandole dalla 
combinazione dei caratteri di ritorno a capo e avan- 
zamento riga (Chr(13) + Chr(lO)) rappresentati dalla 
costante vbCrLf. 

La funzione DeterminaTempo dovrà controllare il 
valore della proprietà Checked di ogni CheckBox. Se 
il valore della proprietà Checked è pari a True, si 
dovrà comporre la stringa informativa aggiungen- 
do la condizione atmosferica corrispondente al 
CheckBox se-lezionato: 



Private Function DeterminaTempo() As String 


Dim TmpStringa 


As String 




TmpStringa = "" 


If CheckBoxSole. Checked = True Then 


TmpStringa = 


TmpStringa 


+ " Sole" 


End If 


If CheckBoxPioggia. Checked 


= True Then 


TmpStringa = 


TmpStringa 


+ " Pioggia" 


End If 


If CheckBoxNeve. Checked = 


True Then 


TmpStringa = 


TmpStringa 


+ " Neve" 


End If 


If CheckBoxVento. Checked = 


True Then 



TmpStringa = 


TmpStringa + 


' Vento" 


End If 


DeterminaTempo 


= TmpStringa 




End Function 



La funzione DeterminaGiorno dovrà controllare il 
valore della proprietà Checked di ogni RadioButton. 
Appena un RadioButton presenta un valore della 
proprietà Checked pari a True, si dovrà restituire il 
giorno corrispondente al RadioButton selezionato e 
si dovrà uscire dalla funzione (tramite l'istruzione 
Exit Function), poiché nessun altro RadioButton 
può avere il valore della proprietà Checked pari a 
True. 



Private Function Determ 


naGiorno() 


As String 


If RadioButtonLunedi. 


Checked = 


True Then 


DeterminaGiorno = 


= "Lunedi:" 




Exit Function 


End If 


If RadioButtonMarted 


.Checked = 


True Then 


DeterminaGiorno = 


= "Martedì:' 




Exit Function 


End If 


If RadioButtonMercoledi. Checked 


= True Then 


DeterminaGiorno = 


= "Mercoled 


:" 


Exit Function 


End If 


If RadioButtonGioved 


.Checked = 


True Then 


DeterminaGiorno = 


= "Giovedì:" 




Exit Function 


End If 


If RadioButtonVenerd 


.Checked = 


True Then 


DeterminaGiorno = 


= "Venerdì:' 




Exit Function 


End If 


If RadioButtonSabato. Checked = 


True Then 


DeterminaGiorno = 


= "Sabato:" 




Exit Function 


End If 


If RadioButtonDomen 


ca. Checked 


= True Then 


DeterminaGiorno = 


= "Domenica:" 


Exit Function 


End If 


End Function 



CONCLUSIONI 

Quando si dispone di un numero limitato di scelte 
i controlli RadioButton e CheckBox sono certamente i 
controlli più indicati da utilizzare, ma se le opzioni 
aumentano di numero non è elegante proporre 
all'utente una finestra piena zeppa di controlli. 
VB.Net mette a disposizione altri controlli che pos- 
sono essere utilizzati per proporre all'utente una 
serie di opzioni diverse: i controlli ListBox (caselle 
di riepilogo) e ComboBox (caselle combinate) che ve- 
dremo nel prossimo articolo. 

Ing Luigi Buono 
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FindForm 
e parent 



Per referenziare 
la finestra in cui 
si trova un controllo è 
bene usare la pro- 
prietà FindForm piut- 
tosto che la proprietà 
Parent, poiché la pro- 
prietà Parent può non 
corrispondere al con- 
trollo Form restituito 
dal metodo FindForm. 
Se, ad esempio, un 
controllo RadioButton 
è contenuto in un 
controllo GroupBox 
ed il controllo Group 
Box si trova in una 
Form, l'oggetto Pa- 
rent del controllo Ra- 
dioButton è Group- 
Box mentre soltanto 
l'oggetto Parent del 
controllo GroupBox 
sarà la Form. 
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^Approfondimento sul concetto di ereditarietà. 

Approfondimento sul 
concetto di ereditarietà 



Continua il nostro viaggio nei meandri dell'ereditarietà. 
In questa lezione si parlerà di costruttori, di 
nascondimento e di redifinizione. Si scopriranno, inoltre, 
alcuni nuovi pregi dell'ereditarietà. 



File sul CD 



\soft\codice 
\csharpl7.zip 



File sul Web 

www.ioprogrammo.net/ 
files/72/csharpl7.zip 



Casting 
fra classi 
in rapporti 
di ereditarietà 



n^TISi supponga di 
YJ\ avere due classi A 
e B, nelle quali B deriva 
da A. Sappiamo che è 
possibile fare quanto 
segue, cioè memoriaz- 
zare un'istanza di B in 
un riferimento di tipo 
A: 

A ri fTi pò A = new B(); 

In questo modo, sul- 
l'oggetto creato posso- 
no essere richiamati i 
membri tipici dell'in- 
terfaccia di A. Se, ad un 
certo punto, si deside- 
ra fare marcia indietro 
e tornare ad un riferi- 
mento di tipo B, è pos- 
sibile impiegare il ca- 
sting: 

B rifTipoB = (B)rifTipoA; 



La precedente lezione ha introdotto il fondamen- 
tale concetto di ereditarietà. Abbiamo visto cosa 
significa creare una gerarchia di classi in rap- 
porti di ereditarietà, attraverso alcune applicazioni 
pratiche. Sono stati svelati i primi misteri collegati al- 
l'argomento. Questa lezione approfondisce la prece- 
dente, elencando alcune norme ed alcune possibilità 
che è indispensabile conoscere per fare un uso proficuo 
dell'ereditarietà. 

EREDITARIETÀ 
E COSTRUTTORI 

Finora abbiamo parlato di ereditarietà, ma non abbia- 
mo ancora preso in considerazione i rapporti che cor- 
rono tra i costruttori di una superclasse e quelli delle 
sue sottoclassi. Prima regola: i costruttori non vengono 
ereditati. Se una classe X dispone di un costruttore con 
tre argomenti di tipo string, giusto per citare un esem- 
pio, una sua sottoclasse Y non disporrà automatica- 
mente dello stesso costruttore. Vale sempre la medesi- 
ma norma, anche nei casi di ereditarietà: se nessun co- 
struttore è esplicitamente dichiarato, la classe verrà au- 
tomaticamente dotata di un costruttore di default, pri- 
vo di argomenti, che non compie alcuna operazione. 
Al contrario, se si definisce anche un solo costruttore, 
quello di default privo di argomenti non sarà più for- 
nito automaticamente dal linguaggio. Seconda regola: 
quando si istanzia una sottoclasse, almeno uno dei co- 
struttori della sua superclasse deve essere richiamato impli- 
citamente o esplicitamente. Andiamo per casi. Quando si 
istanzia una sottoclasse, mediante uno qualsiasi dei 
suoi costruttori, viene automaticamente richiamato il 
costruttore senza argomenti della sua superclasse. La 
verifica è semplice: 

class A { 
public A() { 
System. Console. Writel_ine("Costruttore di A");} 



} 

class B : A { 
public B() { 
System. Console. WriteLine("Costruttore di B"); } 
} 

Eseguiamo un test servendoci delle due classi appena 
definite: 

class Test { 
public static void Main() { B b = new B(); } } 

L'output prodotto è il seguente: 

Costruttore di A 
Costruttore di B 

Come è possibile osservare, un oggetto di tipo B è sta- 
to costruito eseguendo prima il costruttore della su- 
perclasse A e poi quello della sottoclasse B, in questo 
preciso ordine. La norma vale finché la superclasse di- 
spone di un costruttore privo di argomenti. In caso 
contrario, è necessario specificare esplicitamente quale 
dei costruttori della superclasse vada richiamato, al- 
l'interno di ogni costruttore della sottoclasse realizzata. 
A tal fine, ile ostruttore della classe derivata va dichia- 
rato al seguente modo, facendo uso della parola base. 

costruttore-derivato(argomenti) : base(argomenti) { 
// - } 



Ecco un esempio: 




class A { 


public int x; 


public A(int x) { this.x = x; 


} 


public int getX() { return x, 


} 


} 


class B : A { 
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public int y; 

public B(int x, int y) : base(x) { this.y = y; 

public int getY() { return y; } 

> 

class Test { 
public static void Main() { 
B b = new B(5, 7); 
System. Console. Writel_ine("b.x = 
System. Console. Writel_ine("b.y = 

> 



+ b.getXQ); 
+ b.getYQ); } 



In A è stato definito un solo costruttore, che accetta un 
parametro di tipo int. In questo modo, nessun costrut- 
tore privo di argomenti è più disponibile. In B è stato 
introdotto un costruttore con due argomenti di tipo int. 
Il primo di essi, x, viene fornito al costruttore della su- 
perclasse A, attraverso una chiamata a base: 

public B(int x, int y) : base(x) 

Eseguendo il programma, si ottiene il seguente output, 
che rispetta le aspettative: 

b.x = 5 
b.y = 7 

Concludiamo il paragrafo con un ulteriore esempio, 
ottenuto revisionando le classi Persona e Studente esa- 
minate nel corso dell'appuntamento precedente: 



class Persona { 


public 


string nome; 


public 


string cognome; 


public 


Persona(string nome, string cognome) { 


this. 


nome = nome; 


this. 


cognome = cognome; } 


public 


string getNome() { return nome; } 


public 


string getCognomeQ { return cognome; } 


} 



In questa versione di Persona, sono stati rimossi i me- 
todi setNomeO e setCognomeO. Ora è possibile imposta- 
re i campi nome e cognome direttamente alla creazione 
di un oggetto Persona, servendosi del costruttore della 
classe. Fin qui, nessun problema. Ma cosa accade nella 
sottoclasse Studente? Torniamo a considerarla nella sua 
formulazione originaria: 

class Studente : Persona { 

public string matricola; 

public void setMatricola(string matricola) { 
this. matricola = matricola;} 

public string getMatricola() { return matricola; } 
} 

Mettiamo insieme le due classi in un Maini) d'esempio: 



Studente s = new Studente(); 

s.setMatricola("Q9204167"); 

System. Console. Writel_ine("Nome: " + s.getNome()); 

System. Console. Writel_ine("Cognome: " 

+ s.getCognome()); 
System. Console. Writel_ine("Matricola: " + s.getMatricolaQ); } 



La compilazione non riesce. L'errore è il seguente: 

error CS1501: Nessun overload del metodo "Persona " accet- 
ta "0" argomenti 

La classe Studente non ha costruttore. Pertanto, il com- 
pilatore gliene fornisce uno di default, privo di argo- 
menti, che non compie alcuna operazione. Nella sua 
dichiarazione, quindi, non ci sarà nessuna chiamata a 
base. Ne consegue che, alla creazione di un oggetto Stu- 
dente, sarà richiesto un costruttore di Persona privo di 
argomenti. Giacché non esiste un costruttore di questo 
tipo, l'operazione è impossibile. Per questo, il compila- 
tore interrompe il proprio operato, impedendo anzi- 
tempo la catastrofe. Quindi, o dotiamo Persona di un 
costruttore privo di argomenti, oppure definiamo uno 
o più costruttori in Studente che facciano uso di base. 
Optiamo per la seconda soluzione, che tecnicamente è 
quella più corretta: 

class Studente : Persona { 
public string matricola; 
public Studente(string nome, string cognome, string 

matricola) : base(nome, cognome) { 
this. matricola = matricola; } 
public string getMatricola() { return matricola; } 
} 

Missione compiuta! Da questo momento in poi, potre- 
mo creare istanze di Studente ricalcando il seguente 
modello: 

Studente s = new Studente("Mario", "Rossi", "09204167"); 

Aggiustiamo il Maini) in tal direzione: 





Classe 
Studente 



\~rK\ La classe Studen- 
r-J\ te non ha costrut- 
tore. Pertanto, il com- 
pilatore gliene fornisce 
uno di default, privo di 
argomenti, che non 
compie alcuna opera- 
zione. Nella sua dichia- 
razione, quindi, non ci 
sarà nessuna chiamata 
a base. 



Ora le tre classi Persona, Studente e Test, insieme, pos- 
sono essere compilate ed eseguite. L'output è: 



class Test { 
public static void Main() { 



Nome: Mario 
Cognome: Rossi 
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a: 



Membri classi 
derivate 

I I membri delle 
| classi derivate 
possono avere lo 
stesso nome dei 
membri delle corri- 
spondenti classi ba- 
se. In una situazione 
di questo tipo, l'ele- 
mento della classe 
derivata nasconderà 
quello della sua clas- 
se base. 



Matricola: 09204167 



NASCONDIMENTO DEI NOMI 

I membri delle classi derivate possono avere lo stesso 
nome dei membri delle corrispondenti classi base. In 
una situazione di questo tipo, l'elemento della classe 
derivata nasconderà quello della sua classe base: 



class A { public int i = 1; } 


class B : A { public int i = 2;} 


class Test { 


public static void Main() { 


B b = new B(); 


System. Console. WriteLine(b.i); } 


> 



La proprietà i definita nella classe derivata B nasconde 
l'omonima proprietà della classe base A. Nonostante la 
compilazione riesca senza problemi, il compilatore 
emette un segnale di avviso (warning): 

warning CS0108: La parola chiave new è necessaria in "B.i" 
perché nasconde il membro ereditato "Ad ". 

In sostanza, il compilatore non sa se il nascondimento 
di i sia intenzionale o meno, per questo ci avvisa che 
nella classe base A è già presente una proprietà chia- 
mata i, che stiamo nascondendo. Se si vuole evitare 
questo warning, è sufficiente far capire al compilatore 
che il nascondimento è del tutto intenzionale. Per riu- 
scire nell'intento, è possibile fare un particolare uso del- 
la parola chiave new. 

class B : A { public new int i = 2;} 

In questo modo, il programmatore dichiara la consape- 
volezza del nascondimento, ed il compilatore non avrà 
più nulla da segnalare. Si è visto un esempio basato su 
una proprietà, ma il medesimo discorso vale anche nei 
confronti dei metodi: 

class A { 
public void saluta() { 
System. Console. Writel_ine("A ti saluta!");} 
> 

class B : A { 
public new void saluta() { 
System. Console. Writel_ine("B ti saluta!"); } 

} 

class Test { 
public static void Main() { 

B b = new B(); 

b.saluta(); } 
> 

Eseguendo il programma, come oramai dovrebbe esse- 
re facile intuire, l'output sarà: B ti saluta! 
Se, ad un certo punto, si desidera fare in modo che la 



classe derivata richiami ed utilizzi un membro nasco- 
sto della sua classe base, si può fare un uso particolare 
della parola chiave base: 



class B 


: A{ 








public 


new void 


saluta() { 






base 


salutaQ; 








System. Console. WriteLine(' 


B ti saluta! 


"); > 


} 



La chiamata a base.salutaO fa in modo che venga ese- 
guito il metodo salutai) definito nella superclasse A. 
L'output ora sarà: 

A ti saluta! 
B ti saluta! 

UTILIZZO 

DELLE CLASSI DERIVATE 

Un aspetto che rende utile la pratica dell'ereditarietà 
consiste nel fatto che una variabile che fa riferimento 
ad una superclasse può fare riferimento anche ad una 
sua qualsiasi sottoclasse. Detto a parole sembra com- 
plicato, anche se in realtà non lo è. Un codice esempli- 
ficativo ci sarà d'aiuto: 

class A { 

public void provaQ { 

System. Console. WriteLine("prova() di A");} 
> 

class B : A { 
public new void provaQ { 

System.Console.WriteLine("prova() di B"); } 

} 

class C : B { 

public new void provaQ { 

System.Console.WriteLine("prova() di C"); 

_} 
> 

class Test { 
public static void MainQ { 

A al = new AQ; 

A a2 = new BQ; 

A a3 = new CQ; 

al.provaQ; 

a2.prova(); 

a3.prova(); 

_} 
} 

Ci sono tre classi, chiamate A,B e C, disposte secondo 
la seguente gerarchia: 
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Nella classe di verifica Test, si eseguono le seguenti di- 
chiarazioni: 

A al = new A(); 
A a2 = new B(); 
A a3 = new C(); 

Sono state dichiarate tre variabili, tutte di tipo A. In al, 
come consuetudine, è stato memorizzato il riferimento 
ad un oggetto di tipo A Fin qui, nulla di nuovo. In al e 
aò, invece, abbiamo memorizzato delle istanze di B e di 
C. Ciò è possibile grazie alla norma illustrata in apertu- 
ra di paragrafo. Successivamente, abbiamo invocato il 
metodo provai) su ogni istanza creata, ottenendo l'out- 
put: 

prova() di A 
prova() di A 
prova() di A 

Nonostante il nascondimento del metodo provai) effet- 
tuato in B e C, è stato richiamato tre volte il metodo pro- 
vai) definito in A. Questo avviene poiché le istanze di B 
e C sono state memorizzate in un riferimento di tipo A. 
Dunque, la natura del riferimento alla classe rende più 
o meno valido il nascondimento di un membro. Se l'i- 
stanza di C venisse memorizzata in un riferimento di 
tipo B, si otterrebbe una chiamata a provai) di B. Si può 
dimostrare: 



class Test { 


public static void 


Main() { 


B b = new 


C(); 




b.prova(); 


} 


} 



L'output sarà: 
provai) di B 

RIDEFINIZIONE 
DEI METODI 

La ridefinizione di un metodo è qualcosa di apparente- 
mente simile al nascondimento dello stesso. La sostan- 
za, infatti, è la stessa: si dota la classe derivata di un me- 
todo con la stessa firma di un altro metodo presente 
nella classe base. La ridefinizione, però, entra in gioco 
quando tale metodo della classe base è definito virtua- 
le, con la parola chiave virtuali 



class A { 


public virtual void prova() { 


System. Console. WriteLine("prova() di 


A"); 


} 


> 



Il metodo provai) di A, ora, è virtuale. Può, quindi, es- 
sere sottoposto a ridefinizione. La ridefinizione di pro- 
vai), in una classe derivata da A, è simile al nascondi- 
mento, con l'eccezione che va usata la parola chiave 
override al posto della già nota new: 



class B 


: A{ 




public 


override void prova() { 




System. Console. WriteLine("prova() 


di B"); 


} 


} 



Eseguiamo un test: 



class Test { 


public static void Ma 


n(){ 


A a = new 


A(); 




B b = new 


B(); 




a.provaO; 


b.provaO; 


} 




} 



L'output è: 

provai) di A 
provai) di B 

Fin qui, nessuna novità riscontrata nei confronti del na- 
scondimento. Proviamo, però, a memorizzare l'istanza 
di B in un riferimento di tipo A: 



class Test { 


public static void Ma 


n(){ 


A al = new 


A(); 




A a2 = new 


B(); 




al.provaO; 


a2.prova(); 


} 




} 



L'output non cambia: 

provai) di A 
provai) di B 

Quindi, riassumendo, la ridefinizione fa in modo che la 
selezione del metodo da richiamare dipenda dalla na- 
tura stessa dell'oggetto, e non dal tipo del riferimento 
in cui lo si memorizza, come avveniva invece con le 
tecniche di nascondimento. Anche se l'istanza di B è 
stata memorizzata in un riferimento di tipo A, la ver- 
sione di provai) richiamata è quella di B. 

CONCLUSIONI 

Termina lo spazio a disposizione per questo mese, ma 
l'argomento ereditarietà non è ancora esaurito. Vi 
aspetto dunque per l'appuntamento successivo, quan- 
do il discorso sarà ripreso da dove lo si interrompe ora. 

Carlo Pelliccia 
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''Un punto cardine del linguaggio: le librerie. 

Namespace 
e stringhe 

A partire da questa puntata daremo un'occhiata alle 
principali caratteristiche delle librerie standard del C+ + . 
Iniziamo il nostro viaggio dalla libreria per il trattamento 
delle stringhe. Ben presto abbandoneremo i char*! 



File sul CD 



\soft\codice\ 
Lez_15.zip 



File sul WEB 

www.ioprogrammo.net 
/files/72/Lez_15.zip 



Come lo stesso Stroustrup asserisce, nessun pro- 
gramma è scritto partendo dalle istruzioni basi- 
lari del linguaggio di programmazione: prima 
si sviluppano le librerie contenenti le funzioni di cui si 
fa uso; assumendo queste librerie come base di parten- 
za, quindi, si procede allo sviluppo di ulteriori pro- 
grammi. 

Questo genere di approccio è quello seguito nella defi- 
nizione della libreria standard per il C++: dopo la defini- 
zione del linguaggio, si è proceduto alla definizione di 
librerie di supporto che rendessero possibile program- 
mare in C++ senza dover "reinventare la ruota". Ov- 
viamente, non è obbligatorio (anche se fortemente con- 
sigliato) fare uso di tali librerie: i creatori del C++ han- 
no lasciato la massima libertà ai programmatori, i qua- 
li possono benissimo ignorare resistenza della libreria 
standard (un po' come abbiamo fatto noi fino ad ora). 
Essenzialmente, la libreria standard del C++ include 
tutte quelle utilità la cui funzione possa essere necessa- 
ria all'interno di un qualsiasi programma, sia esso 
avanzato o basilare. Essa comprende le principali strut- 
ture dati e i principali algoritmi per lavorare con tali 
strutture. Tutte le utilità introdotte sono state inserite 
seguendo i criteri di frequenza di utilizzo (la libreria in- 
clude solo quelle cose che vengono usate praticamente 
da tutti i possibili programmatori C++), usabilità (faci- 
lità di utilizzo e apprendimento, nei limiti del possibile) 
e ottimizzazione (Fuso delle funzionalità fornite dalla li- 
breria non deve provocare considerevoli overhead, cioè 
"appesantimenti", nei programmi). All'interno della li- 
breria standard si trovano essenzialmente le seguenti 
cose: 

• la libreria standard del C; 

• supporto per stringhe e manipolatori di stream; 

• supporto per diversi tipi di "oggetti contenitore" , cioè 



le principali strutture dati utilizzabili nei program- 
mi (es. pile, code, vettori); 

• supporto per il calcolo numerico e scientifico (es. 
numeri complessi, operatori logici); 

• supporto per l'ambiente run-time (es. gestione del- 
le eccezioni). 

Spesso, si sente parlare della Standard Template Library 
(STL): essa non è la libreria standard del C++, ma un 
suo sottoinsieme, scritto in gran parte da Alexander 
Stepanov. Ci si riferisce alla STL solitamente per indica- 
re l'insieme dei contenitori, iteratori ed algoritmi inclusi 
nella libreria standard. 



I NAMESPACE 

Molte puntate fa (nella prima puntata, in realtà) par- 
lammo dello scope, dicendo che esso rappresenta Y ambi- 
to di visibilità di una variabile. Il concetto di namespace è 
molto vicino al concetto di scope. Si può pensare ai na- 
mespace come a degli "spazi dei nomi": definire un na- 
mespace significa raggruppare sotto un nome comune 
un insieme di elementi correlati, mantenendo quindi 
separati gli elementi che appartengono a namespace di- 
versi. I namespace sono molto utili anche, ad esempio, 
nella creazione di librerie di funzioni, oppure per sepa- 
rare versioni diverse di codici o classi. 
Usare un namespace significa rendere visibili dei nuovi 
elementi all'interno dei nostri programmi. Vediamo un 
esempio di definizione di un namespace. 

namespace Acquano 
{ 
class Pesce 

//codice della classe 
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Base 



} 



Si noti che la definizione di un namespace non termina 
con il ";", a differenza di ciò che si fa per le classi. Con 
la definizione precedente, si è inteso dire che solamen- 
te usando il namespace Acquario, la classe Pesce sarà visi- 
bile al nostro programma. L'utilità dei namespace diven- 
ta evidente nel momento in cui si ha a che fare con clas- 
si omonime. Se si avesse la seguente definizione di na- 
mespace: 

namespace LaghettoArtificiale 
{ 
class Pesce 

//codice della classe 

}; 

} 

le classi definite nel nuovo namespace (e analogamente 
per tutti gli altri elementi nel namespace) sarebbero altre 
classi, omonime a quelle definite nel namespace Acqua- 
rio, ma appartenenti ad un namespace diverso. Le classi 
così definite sono utilizzabili anche in contemporanea, 
mediante un uso opportuno dell'operatore di scope re- 
solution 
Ad esempio: 

LaghettoArtificiale: : Pesce pi ("Trota"); 



Acquario:: Pesce p2("Discus"); 

sarebbero due oggetti di due classi diverse (anche se 
omonime), e quindi potrebbero coesistere all'interno 
dello stesso programma: infatti, la classe Pesce di cui 
fanno parte è nel primo caso quella del namespace La- 
ghettoArtificiale, nel secondo quella del namespace Ac- 
quario. La definizione di un namespace può essere anche 
divisa in più file, utilizzando le direttive al compilatore 
#ifndef e Mefine. Questo è molto utile per estendere un 
namespace già esistente, aggiungendovi, ad esempio, 
altre classi. La struttura del codice per tale estensione è 
la seguente: 

//file acquariol.h 

#ifndef ACQ1 

#define ACQ1 

namespace Acquano 

{ 

//...contenuto del namespace... 

> 

#endif 

//file acquario2.h 

#ifndef ACQ2 

#define ACQ2 

#include "acquariol.h" 



namespace Acquano 

{ 

//...estensione del namespace Acquario., 

} 

#endif 



COSA SONO LE STRINGHE? 

Vedremo molto presto che il discorso appena fatto sui 
namespace ci tornerà utile per l'utilizzo delle librerie 
standard che implementano le stringhe. Ma cosa si in- 
tende per "stringa"? Per un programmatore C, una 
stringa altro non è che un array di caratteri che termina 
con un carattere speciale detto "terminator e ài stringa" 
(rappresentato da "\0", cioè uno zero binario, al termi- 
ne della stringa). Tale carattere è necessario per potere 
utilizzare le funzioni standard del C per la manipola- 
zione di stringhe. Una rappresentazione così "grezza" 
del concetto di stringa, presenta però notevoli proble- 
mi, ad esempio la necessità di ridimensionare a mano la 
dimensione dell' array qualora si rendesse necessario 
ingrandire la stringa, oppure l'attenzione da parte del 
programmatore a non scrivere su zone di memoria or- 
mai deallocate. È per questo che si è deciso di dotare il 
C++ di una libreria standard per la manipolazione del- 
le stringhe attraverso un nuovo tipo: string. In C++ un 
oggetto di tipo string (che da ora in poi sarà chiamato, 
per semplicità, "stringa") ha due vantaggi rispetto al 
suo analogo in C: 

• è un tipo vero e proprio, con tanto di funzioni che 
ne fanno uso (ad es. IT/O con i classici operatori è 
già ridefinito per fare uso anche di oggetti di tipo 
stringa), e contiene al proprio interno molte infor- 
mazioni utili per il compilatore ed il programmato- 
re (ad es. la lunghezza della stringa, la sua locazio- 
ne nella memoria, il numero di caratteri da cui è co- 
stituita); 

• una stringa non è un array di caratteri che termina 
con un "carattere di terminazione": nessuna delle 
funzioni della libreria standard fa implicito riferi- 
mento all'esistenza di tale carattere né, quindi, il 
programmatore se ne deve curare. 

Piccolo dazio da pagare a cotanta potenza espressiva è 
il dovere includere l'intestazione <string> nel proprio 
codice, oltre ad aggiungere la seguente riga di codice: 

using namespace std; 

che indica al compilatore che si farà riferimento in se- 
guito al namespace std (ecco il perché del paragrafo pre- 
cedente!), "std" sta per "standard" ed è indicativo del 
fatto che stiamo utilizzando proprio le librerie con que- 
sta caratteristica. 

Bene, ora che abbiamo visto come informare il compi- 
latore della nostra volontà di utilizzare il tipo string, ve- 
diamo come utilizzarlo. 




Ó 



Contatta 
gli autori! 

Se hai suggeri- 
menti, critiche, 
dubbi o perplessità 
sugli argomenti trat- 
tati e vuoi proporle 
agli autori puoi scrive- 
re agli indirizzi: 

alfredo.marroccelli(a> 
libero.it (Alfredo) 
e 

marcodelgobbo(a>libero.it 
(Marco) 

Questo contribuirà si- 
curamente a migliora- 
re il lavoro di stesura 
delle prossime punta- 
te. 
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Stringhe 

Possiamo adope- 
rare strìng come 
un tipo di variabile 
predefinita a tutti gli 
effetti. È possibile di- 
chiarare una variabile 
di tipo strìng nel se- 
guente modo (ormai 
conosciuto): 

strìng si 



USO DELLE STRINGHE 

Abbiamo detto che possiamo adoperare strìng come un 
tipo di variabile predefinita a tutti gli effetti. È possibile 
dichiarare una variabile di tipo strìng nel seguente mo- 
do (ormai conosciuto): 

string si; 

questa stringa non contiene alcun carattere e la sua lun- 
ghezza è 0. Tuttavia quello che molto spesso si fa è ini- 
zializzare una stringa contestualmente alla sua dichia- 
razione, cioè assegnare alla stringa un contenuto all'in- 
terno della stessa istruzione con la quale si dice al com- 
pilatore che la stringa esiste. Ci sono molti modi per fa- 
re questo e sicuramente una panoramica con l'uso di 
qualche riga di codice risulterà più espressiva di mille 
parole: 

//inizializzazione con costruttore a 1 argomento 

string s2("Sono la stringa numero 2!"); 

//inizializzazione da costante 

string s3 = "Io la numero 3!"; 

//s3bis e' inizializzata con il contenuto di s3 

string s3bis(s3); 

nulla di sconvolgente quindi (almeno si spera!). Questi 
che abbiamo elencato sono i metodi più semplici e in 
realtà ve ne sono altri che consentono (ai programma- 
tori più smaliziati) una notevole flessibilità nell'uso del- 
le stringhe. Tuttavia tutti questi ulteriori modi possono 
essere ricondotti ai quattro sopra elencati, per cui sa- 
rebbe opportuno che il bravo programmatore C++ co- 
noscesse questi ultimi a menadito. 
Tutto questo è interessante ma a dire il vero non si di- 
scosta poi molto dall' utilizzo "raw" di stringhe, intese 
come semplici array di caratteri. Come abbiamo già 
avuto modo di dire, quello che rende veramente utili le 
librerie standard, sono il gran numero di funzioni ac- 
cessorie già pronte all'utilizzo che esse mettono a di- 
sposizione. 

Tra le prime funzioni di questo tipo che vogliamo men- 
zionare, ci sono indubbiamente gli overload degli operato- 
ri più comuni. Utilizzando il tipo string, infatti, è possi- 
bile ad esempio concatenare due stringe semplicemente 
utilizzando l'operatore "+", nel modo più intuitivo che 
ci si possa aspettare: 

string si = "La mia prima"; 

string s2 = " stringa concatenata"; 

string sl_s2 = si + s2; //"La mia prima stringa 

concatenata" :-) 

in questo caso la concatenazione è avvenuta contestual- 
mente a una inizializzazione, ma è del tutto possibile 
concatenare una stringa a un'altra stringa già esistente, 
ad esempio: 

string s3 = "Seconda"; 

s3 = s3 + s2; //"Seconda stringa concatenata" 



Fortunatamente i progettisti delle librerie standard non 
ci fanno mancare nulla, per cui è anche possibile scrive- 
re il precedente frammento di codice condensandolo 
nella più breve istruzione: 

s3 += s2; //alternativo al precedente 

che utilizza l'operatore "+=" e ha il medesimo signifi- 
cato. Dopo avere concatenato tutte queste stringhe, ov- 
viamente la cosa più intuitiva che ci viene in mente di 
fare è... STAMPARE una stringa a schermo! Nulla di più 
semplice: basta utilizzare l'overload dell'operatore di 
estrazione "«" in concomitanza col consueto stream 
standard di output a consolle (per gli amici "cout")', il 
codice è il seguente: 

string s4 = "Prova di stampa con cout"; 
cout << s4; 

e, una volta eseguito, stamperà: 

Prova di stampa con cout 

come è lecito attendersi. Ovviamente è possibile conti- 
nuare ad usare la normale concatenazione di flussi per 
cout, ma, si badi bene, questo non ha nulla a che vedere 
con la concatenazione di stringhe, sebbene in molti casi il 
risultato possa essere il medesimo: 



string s5 = ' 


*Ci"; 




string s6 = x 


v ao!"; 




//stampo una stringa concatenata 


cout << (s5 


+ s6) << 


endl; 


//concateno 


i FLUSSI e 


i stampa! 


cout << s5 


<< s6 << 


endl; 



Questo codice stamperà: 

Ciao! 
Ciao! 

anche se i due saluti sono ottenuti in maniera del tutto 
diversa. Molto comodo risulta, al contrario di ciò che 
accade utilizzando gli array di caratteri, l'overload del- 
l'operatore di inserimento "»", che consente di im- 
mettere da tastiera una stringa di lunghezza arbitraria 
senza stare a preoccuparci di dimensionare in maniera 
corretta l'array (questo è comunque un discorso valido 
in ogni caso). Per fare un esempio di utilizzo di questo 
operatore, rispolveriamo un programmino che i lettori 
più affezionati sicuramente ricorderanno, e modifichia- 
molo utilizzando le stringhe: 

#include <iostream> 
#include <string> 
using namespace std; 
void main() 

{ 

cout << "Ciao! Come ti chiami? "; 
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Dovreste già sapere cosa produce in output questo pro- 
gramma :-) Una cosa importante da notare è che in que- 
sto caso citi utilizza come terminatore di stringa il carat- 
tere SPAZIO per cui si potrebbe produrre qualche risul- 
tato indesiderato: 

Ciao! Come ti chiami? Homer Simpson 
Ciao Homer! Io sono HAL 9000... 

anziché: 



l'operatore di disuguaglianza "!=" che ha il significato 
opposto. Le librerie standard ridefiniscono in realtà an- 
che molti altri operatori del C++, tra i quali gli operato- 
ri di maggioranza /minoranza (">"/'<"/">="/"<=")• 
Il significato di "stringa maggiore di un'altra stringa" po- 
trebbe apparire leggermente più ostico di quanto visto 
sino ad ora, ma in realtà il concetto è abbastanza sem- 
plice. La comparazione che svolgono questi operatori è 
di tipo lessicale. Questo vuol dire che una stringa sarà va- 
lutata maggiore di un'altra stringa se il primo carattere (par- 
tendo da sinistra) per il quale le due stringhe differiscono vie- 
ne, in ordine alfabetico, dopo il corrispondente carattere nella 
seconda stringa. Un po' contorto ma molto semplice. Ad 
esempio avendo le seguenti stringhe: 




Ciao! Come ti chiami? Homer Simpson 
Ciao Homer Simpson! Io sono HAL 9000... 



string casa = "casa"; 
string castello = "castello"; 



Per ottenere il secondo comportamento può essere uti- 
le utilizzare la funzione getline(): si sostituisce: 



cin >> nome; 



con 



getline(cin,nome); 



La funzione getlineO inserisce nella stringa l'intera se- 
quenza di caratteri battuta da tastiera prima di preme- 



FACCIAMO PURE PARAGONI 

Un altro overload di indubbia utilità nella programma- 
zione pratica è senz'atro l'operatore di uguaglianza 
"==". Utilizzandolo, infatti, è possibile testare in ma- 
niera facile e elegante dal punto di vista sintattico, una 
condizione di uguaglianza tra due stringhe. Ecco un 
esempio: 




Questo codice produrrà in output: 

Le stringhe (Ciao!) e (Ciao!) SONO uguali! 
Le stringhe (Ciao!) e (Hello!) NON sono uguali! 

Ovviamente è possibile utilizzare anche l'overload del- 



possiamo vedere che il primo carattere per cui esse dif- 
feriscono è quello in posizione 3 (cominciando a conta- 
re da 0). Per la variabile casa questo carattere è "a", men- 
tre per castello questo carattere è "t" , questo vuol dire 
che la condizione: 

(castello > casa) 

restituirà il valore true (vero), proprio perché la "t" vie- 
ne dopo la "a" nell'alfabeto. È importante notare che è 
definito un ordinamento per tutti i caratteri utilizzati da 
un calcolatore (uno di questi ordinamenti è ad esempio 
il set ASCII), per cui anche se le stringhe che adoperia- 
mo contengono caratteri non contenuti nell'alfabeto (ad 
esempio "/" "?" "&" ecc.) sarà sempre possibile effet- 
tuare una comparazione, in quanto per essa viene uti- 
lizzato proprio il numero intero associato al singolo ca- 
rattere della stringa. Per i caratteri dell'alfabeto vale 
l'ordine alfabetico semplicemente perché i numeri inte- 
ri associati alle lettere seguono lo stesso ordine che se- 
gue l'alfabeto (e cioè "a" viene prima di "b" che viene 
prima di "e" e così via...). 



CONCLUSIONI 

In questa lezione abbiamo dato una panoramica molto 
generale di quelle che sono le stringhe nelle librerie 
standard del C++. L'utilizzo delle stringhe è una delle 
cose più comuni che si possa ritrovare a fare un pro- 
grammatore quando scrive codice e per questo sapere 
padroneggiare, con una certa sicurezza, un set di libre- 
rie universalmente presenti, e per di più notevolmente 
efficienti, è senza dubbio molto importante. Quello che 
abbiamo appena visto non è altro che una goccia nel 
mare delle librerie standard e solo una piccola parte di 
tutte le funzionalità messe a disposizione del tipo 
string. 

Vedremo nella prossima lezione di dare ulteriori nozio- 
ni sull'utilizzo di questa importante caratteristica. Non 
mancate! 

Alfredo Marroccelli e Marco Del Gobbo 



Sul Web 



A chi volesse appro- 
fondire la sua cono- 
scenza sulle librerie 
standard del C++, con- 
sigliamo il validissimo 
libro "Thinking in C++ 
- 2nd ed. - Volume 2" 
di Bruce Eckel e Chuck 
Allison, che rappresen- 
ta sicuramente un otti- 
mo riferimento per i 
programmatori più 
avanzati (o aspiranti 
tali) ed è oltretutto di- 
sponibile gratuitamen- 
te per il download, 
partendo dall'indirizzo 

http://www.mindview.net/ 

Books/TICPP/ 

ThinkinqInCPP2e.html 

Se volete invece dare 
un'occhiata a una refe- 
rence delle funzioni 
standard del C per la 
manipolazione di strin- 
ghe (o meglio: di array 
di caratteri terminati 
da "\0" :-) consultate 
l'indirizzo: 

http://www.cplusplus. 
com/ref/cstrinq/ 
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^ La simulazione e modellazione di fenomeni fisici. 

Applicazione di 
modelli matematici 



Stephen Hawkings nel suo libro "Dal big bang ai buchi 

neri" ci fornisce una suggestiva definizione di modello 

matematico: "un insieme di regole che mettono 

in relazione le quantità presenti nel modello con 

le osservazioni che facciamo della realtà. Il modello esiste 

solo nella nostra mente e non possiede alcuna realtà". 



File sul CD - 



\soft\codice 
\matlab72.zip 



File sul Web 

www.ioprogrammo.net 
/files/72/matlab72.zip 



Un modello, per essere un buon modello, de- 
ve soddisfare due requisiti: descrivere con 
precisione (accuratezza) una grande classe 
di osservazioni sulla base di un modello contenente 
solo qualche elemento arbitrario e fare predizioni 
ben definite sui risultati di future osservazioni. Per 
esempio la legge di gravitazione di Newton/' Quan- 
do descriviamo il comportamento di un fenomeno 
fisico dobbiamo ricorrere al concetto di modello ma- 
tematico. Il modello é sempre e comunque virtuale 
e il software non é altro che una rappresentazione 
stabile, riproducibile e riutilizzabile di un pensiero. 
Esso é costantemente sotto inchiesta e suscettibile di 
confutazioni o, nel migliore dei casi, di migliora- 
menti. Lo scopo ultimo di un modello é proprio 
quello migliorarsi nel tempo sino a divenire adatto 
a descrivere una realtà fisica con un grado di ap- 
prossimazione sufficiente per gli usi per cui é nato. 
Il miglioramento di un modello passa attraverso 
due filoni principali di attività del modellatore: la 
determinazione della struttura del modello e V iden- 
tificazione dei suoi parametri (le costanti ignote). 
Questi due aspetti ci offrono due differenti problemi 
da risolvere: il primo ci pone nella situazione di do- 
ver determinare quali leggi descrivano appropriata- 
mente i fenomeni e con quale grado di accuratezza. 
Una volta compiuto questo passo dovremo tuffarci 
air interno del modello per determinare quei para- 
metri ancora sconosciuti che lo renderanno adatto a 
descrivere appropriatamente la realtà dei fatti. 
Eventualmente, possiamo reiterare il processo fino 
ad arrivare ad uno stadio di sviluppo che sia soddi- 
sfacente. Qui il modello ci viene in soccorso poiché 
possiamo mettere alla prova le nostre idee prima di 



sperimentarle praticamente. E questo un passo im- 
portantissimo del processo di indagine poiché é ora 
possibile scartare le idee peggiori, suffragare le mi- 
gliori e lavorare creativamente per farne nascere di 
nuove. E ognuna deve prendere la via delle prime: 
essere verificata per mezzo del modello, passare il 
setaccio dei test e qualificarsi per essere sperimenta- 
ta nella pratica. Anche se può sembrare un processo 
estremamente semplice e intuitivo si tratta, invece, 
di una parte strutturalmente importante del metodo 
scientifico: una volta identificato un problema é ne- 
cessario fare delle ipotesi sulle sue cause, queste 
vanno obbligatoriamente verificate con una batteria 
di test che possa, in maniera inequivocabile, riget- 
tarle o confermarle. L'analisi dei risultati attesi ci di- 
ce quali ipotesi siano state confutate e quali altre 
confermate. La scienza e la tecnologia progredisco- 
no in questa maniera da molti secoli. Quando ci tro- 
viamo di fronte ad un fenomeno noi dobbiamo com- 
portarci nella stessa maniera se vogliamo che i risul- 
tati dei nostri studi e dei nostri sforzi siano ricono- 
sciuti e considerati autorevoli. Un modello matema- 
tico altro non é che un prototipo della realtà e gli 
strumenti software oggi disponibili ci permettono di 
implementare modelli molto complessi consenten- 
doci di scoprire V intima natura dei fenomeni che 
stiamo esaminando. Come tale, ci consente di esplo- 
rare idee che sarebbero costose da esaminare per 
mezzo di esperimenti reali, di effettuare virtualmen- 
te test che nella realtà sono distruttivi, di studiare fe- 
nomeni non riproducibili in laboratorio, di osserva- 
re l'evoluzione nel tempo di fenomeni troppo veloci 
o troppo lenti, di prevedere comportamenti difficili 
da immaginare a priori. 
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Affrontiamo ora un esempio che ci aiuti a provare 
queste affermazioni. Lo spunto ci viene suggerito 
dallo stesso Stephen Hawkings: la legge della gravi- 
tazione di Newton. Ci daremo come scopo quello di 
descrivere dapprima il moto della Terra attorno al 
Sole e poi aggiungeremo anche la Luna. Il modello 
completo della gravitazione di Newton poggia su 
alcune leggi di valore propedeutico ed enuncia 
quindi le relazioni quantitative. Ma andiamo per or- 
dine; la prima legge dice che un corpo rimane nel 
suo stato di riposo o di moto uniforme su una linea 
retta fino a quando non interviene una forza esterna 
che modifica la situazione. Osservando il moto dei 
corpi celesti ci si accorge che essi si spostano su 
traiettorie ellittiche: ci deve quindi essere una forza 
esterna che modifica lo stato delle cose. La seconda 
legge dice che la quantità di moto di un oggetto 
(massa moltiplicata per la velocità) cambia in ma- 
niera proporzionale alla forza applicata e nella 
stressa direzione in cui viene applicata la forza stes- 
sa. La terza legge dice che ogni azione produce una 
reazione opposta e contraria. E infine, la legge di 
gravitazione universale ingloba in essa tutte le pre- 
cedenti e ne da' anche una quantificazione: 



F = 



Gm 1 m 2 

r 2 



Essa dice che quello che devia i corpi dal loro stato 
di riposo o di moto rettilineo é la forza gravitazio- 
nale che scaturisce dal fatto che i corpi possiedono 
una massa. Questa forza agisce lungo la retta che 
unisce i corpi e fa cambiare continuamente la quan- 
tità di moto. Inoltre, la forza che agisce su un corpo 
dovuta alla presenza dell'altro é identica a quella 
che agisce sul secondo dovuta alla presenza del pri- 
mo. Questa forza complessiva é proporzionale al 
prodotto delle due masse ed inversamente propor- 
zionale al quadrato della distanza che le separa. Le 
forze gravitazionali si possono sommare per ottene- 
re una forza complessiva e quindi questo modello é 
per sua natura estensibile ad un numero di corpi 
qualsiasi. Cominceremo con il vedere come questo 
modello si applica al caso più semplice di due cor- 
pi: il Sole e la Terra. Nell'implementare il nostro mo- 
dello dobbiamo tenere conto di alcune questioni: il 
moto é tridimensionale, bisogna immaginarsi una 
maniera algoritmica di usare il modello, dobbiamo 
scegliere il livello di accuratezza dei valori scelti co- 
me valori iniziali e dobbiamo trovare un buon valo- 
re per il passo temporale al quale intendiamo effet- 
tuare i calcoli. Il fatto che il moto avvenga in tre di- 
mensioni non ci impressiona troppo poiché sappia- 
mo che le forze possono essere sommate per ottene- 
re una risultante e quindi possiamo scomporre la 
nostra forza gravitazionale lungo i tre assi cartesia- 
ni principali (x, y e z) e comunque la forza totale ri- 
sultante sarà corretta. Se pensiamo a cosa che sia ne- 



cessario fare per effettuare i nostri calcoli in manie- 
ra corretta ci accorgiamo che é necessario partire dal 
determinare la velocità alla quale si muovono i cor- 
pi per poi risalire alle posizioni. Così la sequenza di 
calcoli é la seguente: 

v = v + FA t 
V = Pn + vAt 




Fig. la: Delta t = 30 giorni, 6 iterazioni (180 giorni 
complessivi). 



Se procediamo iterativamente in questo modo pos- 
siamo avanzare nel tempo fino a raggiungere un ap- 
propriato orizzonte temporale che descriva il feno- 
meno appropriatamente. In questa maniera possia- 
mo prevedere posizione e velocità dei corpi in fun- 
zione del tempo. Questo procedimento é lineare e 
presuppone che la traiettoria seguita dai corpi nel 
tempo delta t sia rettilinea; cosa che é evidentemen- 
te non corretta poiché sappiamo invece che i corpi 
celesti che interagiscono gravitazionalmente tra lo- 
ro percorrono traiettorie curvilinee. Se pensiamo di 
rimpicciolire "delta t" possiamo minimizzare a pia- 
cimento Terrore che commettiamo ma comunque 
commetteremo sempre un certo errore; il problema 
sta nel renderlo trascurabile. Se proviamo ad iterare 
per un numero di giorni pari a 180 con un passo 
"delta t" di un mese (30 giorni) per iterazione e quin- 
di con un "delta t" pari a 10 giorni, raggiungiamo i 
risultati delle Fig. la e lb. 

Vediamo ad occhio nudo che essi sono qualitativa- 
mente differenti e se guardiamo con maggiore at- 





MATLAB 



Modello 



y-a I Nell'implemen- 
--J\ tare il nostro 
modello dobbiamo te- 
nere conto di alcune 
questioni: il moto é 
tridimensionale, biso- 
gna immaginarsi una 
maniera algoritmica 
di usare il modello, 
dobbiamo scegliere il 
livello di accuratezza 
dei valori scelti come 
valori iniziali e dob- 
biamo trovare un 
buon valore per il 
passo temporale al 
quale intendiamo ef- 
fettuare i calcoli. 



Fig. lb: Delta t = 10 giorni, 18 iterazioni (180 
giorni complessivi). 
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[1] Data 
AspectRatio 



\~rK\ La proprietà Da- 
\^s\ taAspectRatio 
regola l'enfatizzazione 
da dare ai rispettivi 
assi cartesiani. 



[2] View 



I /-al La funzione view 
\ --J\ imposta un an- 
golo sotto il quale si 
decide di vedere la 



[3] Drawnow 

I ^s\ Drawnow impo- 
|Q^ ne di eseguire 
un render della figu- 
ra grafica, altrimenti 
MATLAB visualizza i 
grafici soltanto al 
termine dell'elabora- 
zione. 



tenzione scopriamo che anche numericamente vi so- 
no differenze sostanziali. Per esempio la coordinata 
y massima nell'uno é pari a poco meno di 1.3 IO 11 
mentre nel secondo é pari a quasi 1.4 IO 11 . Matema- 
ticamente parlando stiamo trattando un problema 
del valore iniziale. Qui risolviamo le equazioni del 
moto integrandole numericamente piuttosto che an- 
dare alla ricerca di una soluzione analitica. Il meto- 
do descritto prende il nome di "Metodo di Eulero" . 
Un grande numero di problemi fisici possono esse- 
re risolti usando metodi basati su questa tecnica. Di 
conseguenza, un grande ammontare di sforzi sono 
stati profusi dalla comunità dei matematici per svi- 
luppare versioni veloci ed accurate di queste tecni- 
che. Fino ad ora ci siamo concentrati sul modello 
matematico ma ad un certo punto dobbiamo però 
arrivare a chiederci di quanta accuratezza abbiamo 
bisogno. Questo dipende da un certo numero di fat- 
tori: cosa vogliamo descrivere, la disponibilità di 
dati e misure di accuratezza sufficiente e la disponi- 
bilità di sistemi di calcolo (hardware e software) 
adatti a sopportare il peso computazionale. Qui il 
nostro obbiettivo é quello di comprendere quale sia 
T interazione tra due corpi celesti e sperimentare al- 
cune situazioni notevoli che conosciamo e che use- 
remo come casi di test qualitativo. Questo ci servirà 
per fare evolvere il nostro modello fino a trattare fe- 
nomeni molto complessi. I dati reperibili sui corpi 
del sistema solare sono di qualità sufficiente e sono 
da lungo tempo al vaglio degli astronomi che ne 
controllano V accuratezza con continuità. Per quanto 
riguarda i sistemi di calcolo abbiamo oggi a disposi- 
zione software di calcolo come MATLAB che ci con- 
sentono quello che ci era precluso solo pochi decen- 
ni or sono. La prima simulazione che tenteremo di 
eseguire é relativa al moto terrestre attorno al Sole. 
Per farlo costruiamo il nostro solito script (simulpla- 
net.m) che contiene la definizione delle variabili ca- 
ratteristiche del problema e la chiamata al program- 
ma che effettua la simulazione vera e propria. Con- 
centriamoci ora su quello che é il vero e proprio mo- 
tore di calcolo della nostra simulazione (planet.m). 
La prima operazione che facciamo é quella di ini- 
zializzare la visualizzazione grafica e di predisporre 
r ambiente nel quale mostreremo il risultato dei cal- 
coli. 

function planet(massa_tgt,x_tgt,y_tgt,z_tgt, 

vx_tgt,vy_tgt / vz_tgt / . . . 
massa_int,x_int,y_int,z_int,vx_int,vy_int,vz_int,... 

dT_iter,iteraz, dT); 
% PLANET Simulazione dell'interazione tra pianeti 

% Inizializzazione del campo grafico di disegno 

f=figure; 

set(f,'Renderer',' Zbuffer', . . . 

'Color',[.6 .6 .6]); 
[i]axh=axes('Box','on',... 

'DrawMode'.'Fast',... 



'DataAspectRatio',[l, 1, 1],... 

'Position',[0.1 0.1 0.8 0.8], ... 

'Color',[0 0],... 

'XColor',[l 1 1],... 

'YColor',[l 1 1],... 

'ZColor',[l 1 1]); 
[2] 

view([-45 45]); 
axis equal 
xlabel('asse X ()'); 
ylabel('asse Y ()'); 
zlabel('asse Z ()'); 

Definiamo quindi la costante di gravitazione universa- 
le (G) secondo il sistema internazionale MKS (metri, 
chilogrammi, secondi). Adottiamo subito una termi- 
nologia che ci sarà più chiara quando estenderemo 
la trattazione alle galassie ma che si presta bene an- 
che in questo caso. Chiamiamo il corpo celeste che 
ha maggiore massa e che risiede inizialmente più vi- 
cino al centro di rotazione del sistema (centro di 
massa), "bersaglio", mentre il secondo lo chiamere- 
mo "intruso". Considereremo l'intruso come il corpo 
che con il suo campo gravitazionale va a perturbare 
la quiete o il moto uniforme del bersaglio. 
Nel nostro codice posizioniamo i due punti che rap- 
presentano bersaglio e intruso nelle rispettive posi- 



% Inizializzazione 


variabili 










G = 6.67259e-ll; 


% IN * m^2 / kg^2 










hold on 


% Centri del TARGET e dell'INTRUDER 


bersaglio = plot3( 


x_tgt,y_tgt,z_tgt,' Marker','-',' 
MarkerSize', 25, 'Color' 


,[1 


1 


i]); 


intruso = plot3(x_ 


int,y_int,z_int,'Marker',' 
MarkerSize', 25, 


'Color' 


,[1 


1 


i]); 


[3] 

drawnow 


axis equal; 



Ecco ora che viene la parte più algoritmica del pro- 
gramma. Notiamo subito che abbiamo due cicli 
"for" che ci consentono di minimizzare la rappre- 
sentazione grafica che é sempre dispendiosa come 
tempo e risorse di memoria. Le due variabili che co- 
mandano i cicli sono, dal più interno, "dT_iter" e 
"iteraz". 

La variabile "dT_iter" fa eseguire il calcolo delle ve- 
locità e delle posizioni un certo numero di volte e 
solo allora consente di eseguire uno step di visua- 
lizzazione. 

La variabile "iteraz" fa ripetere questo processo n 
volte. Avendo stabilito un "delta t" appropriato (ve- 
di simulplanet.m) possiamo calcolare l'orizzonte 
temporale della simulazione come prodotto tra del- 
ta t, dTJteraz e iteraz. 
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[4] 

for j = l :iteraz 

for k=l:dT_iter 

% Calcolo della velocita' del centro del pianeta 

TARGET 
opti = x_tgt - x_int; 
opt2 = y_tgt - y_int; 
opt3 = z_tgt - z_int; 

opt4 = (optl^ + opt2^2 + opt3^2 + le^l.S; 
vx_tgt = vx_tgt - G*massa_int*optl/opt4*dT; 
vy_tgt = vy_tgt - G*massa_int*opt2/opt4*dT; 
vz_tgt = vz_tgt - G*massa_int*opt3/opt4*dT; 
% Calcolo della velocita' del centro del pianeta 

INTRUDER 
vx_int = vx_int + G*massa_tgt*optl/opt4*dT; 
vy_int = vy_int + G*massa_tgt*opt2/opt4*dT; 
vz_int = vz_int + G*massa_tgt*opt3/opt4*dT; 
% Aggiornamento della posizione del centro 

del pianeta TARGET 
x_tgt = x_tgt+vx_tgt*dT; 
y_tgt = y_tgt+vy_tgt*dT; 
z_tgt = z_tgt+vz_tgt*dT; 
% Aggiornamento della posizione del centro 

del pianeta INTRUDER 
x_int = x_int+vx_int*dT; 
y_int = y_int+vy_int*dT; 
z_int = z_int+vz_int*dT; 

% Disegno della traiettoria dei centri dei pianeti 
Nne([x_tgt-vx_tgt*dT x_tgt],[y_tgt-vy_tgt*dT 

y_tgt],[z_tgt-vz_tgt*dTz_tgt], , Color',[l 1 0], 

'linewidth',2); 
Nne([x_int-vx_int*dT x_int],[y_int-vy_int*dT 

v_int],[z_int-vz_int*dT z_int], 'Color', [1 1 0], 

'linewidth',2); 
end 

% Varizione della posizione dei centri dei pianeti 
set(bersaglio,'XData',x_tgt,'YData',y_tgt,'ZData',z_tgt); 
set(intruso,'XData',x_int,'YData',y_int,'ZData',z_int); 
% Calcolo del tempo trascorso 
tempo=(j-l)*dT_iter+k; 
[5] 

% Aggiornamento delle visualizzazione 
title(['Tempo: ',num2str(tempo),' 

/',num2str(iteraz*dT_iter)]); 
drawnow 
axis equal; 
end 

Le espressioni matematiche qui utilizzate sono leg- 
germente differenti dalla forma canonica che abbia- 
mo visto sopra. Questo avviene perché siamo in uno 
spazio tridimensionale e quindi dobbiamo calcolare 
la componente della forza generata da ogni singolo 
corpo per mezzo del suo potenziale gravitazionale 
Kepleriano (quindi dipendente soltanto dalla sua 
massa) lungo ogni asse cartesiano (x, y e z). Dato un 
potenziale Kepleriano definito come P(r) = -GM/r 
("M" e' Idi massa del corpo ed "r" è la distanza a cui 
si considera il potenziale), la forza che agisce ad una 



distanza "r" é F(r) = -GM/r 2 . In coordinate cartesiane 
tridimensionali la forza ha componenti Fx, Fy, Fz 
dove Fx = -2GMx/r 3 con espressioni simili nelle al- 
tre due componenti. Notiamo ancora che il termine 
in r 3 non é scritto esattamente così ma compare un 
termine aggiuntivo. Se proviamo a tracciare la cur- 
va delle velocità di un oggetto che percorre un'orbi- 
ta attorno ad un corpo dotato di sufficiente massa in 
funzione della distanza dal corpo, in accordo con la 
forma canonica di Newton notiamo che la velocità 
cresce indefinitamente mano a mano che ci avvici- 
niamo. Questo termine rende invece la simulazione 
più realistica "bloccando" la crescita indefinita della 
velocità all'avvicinarsi dei corpi. Ovviamente si as- 
sume che le masse siano puntiformi, vale a dire con- 
centrate nel centro dei corpi celesti. 
Vale qui la pena di notare due porzioni del codice 
che sono interessanti. Le linee di codice che conten- 
gono le funzioni "line" creano due linee, Luna che 
traccia il movimento del bersaglio, Laltra quello del- 
Lintruso. Appena si esce dal ciclo più interno si in- 
contrano due funzioni "set") abbiamo visto pochi 
momenti fa che le variabili "bersaglio" e "intruso" 
contengono gli handle grafici dei punti che rappre- 
sentano il Sole e la Terra. Queste vengono usate per 
cambiare le loro proprietà di posizione; trattandosi 
di punti, le proprietà "Xdata" , "Ydata" e "Zdata" 
contengono uno scalare. Variando questo scalare 
con le variabili appena calcolate forziamo MATLAB 
a rappresentare i punti nelle loro nuove posizioni. Si 
tratta di un metodo particolarmente veloce poiché 
non implica la creazione ex-novo del grafico ma sol- 
tanto una sua modificazione. Le rimanenti istruzio- 
ni producono ancora qualche marginale operazione 
di maquillage del grafico e quando anche il ciclo più 
esterno si completa termina anche la simulazione. A 
questo punto viene lasciato visibile il grafico risul- 
tante di Fig. 2. 




Fig. 2: Orbita terrestre. 

Possiamo ora provare ad esplorare i risultati della 
simulazione rispetto a tre fattori che sono di qualche 
interesse. Se facciamo uno zoom sul Sole (Fig. 3) ve- 
diamo che la sua traiettoria ha assunto la forma di 
un tre ed esso si trova ora ad una distanza pari a cir- 




MATLAB 



[4] Opt 



\~rK\ Le variabili opt... 
V-J\ vengono usate 
per minimizzare i 
tempi di calcolo e per 
comodità di scrittura 
del codice. 



[5] 



a: 



I La stringa usata 
| come titolo del 
grafico viene aggior- 
nata ad ogni step di 
visualizzazione per 
dare informazioni 
sull'avanzamento 
dell'elaborazione. 
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Sul Web 



Getti ng Started with 
MATLAB 

http://www.math works 

■com/access/helpdesk 

/help/pdf doc/matlab 

/getstart.pdf 

Using MATLAB 

http://www.mathworks 

■com/access/helpdesk 

/help/pdf doc/matlab 

/using ml.pdf 

Using MATLAB 
Graphics 

http://www.mathworks 

■com/access/helpdesk 

/help/pdf doc/matlab 

/graphq.pdf 





X 10* Tempo: 750/750 




7 






6 






5 


A 




4 


) 




j^j 


J 




> 


/ 




1 3 

m 

va 


\ 




2 


i 




1 


/ 







. y 




-1 


- . i i i 






-1 O 1 ; 


i 


asseX() x1Q s 



Fig. 3: Spostamento del Sole dovuto a due orbite 
terrestri. 



ca 6000 km dal punto di partenza. Per comprendere 
bene di cosa si tratti proviamo a considerare il fatto 
che il diametro del Sole é pari a 1390000 km; é come 
dire che se il Sole fosse una pallina da tennis questa 
si sarebbe spostata di circa 0.3 millimetri. Proviamo 
ora a zoomare sulla Terra e vediamo che essa non 
percorre sempre la stessa traiettoria. Questo é prin- 
cipalmente dovuto a due fattori: il Sole si muove an- 
che se di poco e la velocità iniziale é stata calcolata 
in un modo estremamente semplicistico. In pratica 
la velocità é stata calcolata come lo spazio ottenuto 
dalla circonferenza di raggio pari al raggio medio 
dell'orbita terrestre diviso il tempo di un'orbita 
(365.26 giorni). In effetti questa é un'assunzione po- 
co precisa poiché avremmo dovuto assumere un'or- 
bita ellittica. In realtà il nostro scopo era quello di te- 
stare il modello per vedere se era in grado di repli- 
care il fenomeno naturale. Se avessimo il dubbio che 
esso possa simulare traiettorie ellittiche basta pro- 
vare ad aumentare la velocità iniziale del 10% ed ot- 
terremmo subito un'orbita decisamente ellittica. Il 
nostro modello descrive bene il moto di due corpi: 
tentiamo ora di introdurne un terzo che, nel nostro 
caso, é facile individuare nella Luna. Se diamo 
un'occhiata ai file "simulsatél.m" e "satel.m" notiamo 
poche modifiche sostanziali. 

A parte il codice necessario per trattare anche i dati 
della Luna. Notiamo una sola importante modifica: 
il calcolo delle forze (e relative velocità) vede ora 



comparire un ulteriore termine che ci consente di 
calcolare le interazioni applicate al terzo corpo e le 
forze da questo generate sugli altri due. Siamo ora 
pronti a lanciare un'ulteriore simulazione. Il risulta- 
to é particolarmente buono rispetto ad un nuovo fe- 
nomeno che vediamo verificarsi sotto i nostri occhi. 
La traiettoria della Terra é perturbata dalla Luna; in- 
fatti, se osserviamo attentamente vediamo che l'ar- 
co descritto dalla Terra non é più così regolare ma 
presenta degli ondeggiamenti che sono caratteristi- 
ci di questo tipo di interazioni gravitazionali. Que- 
sto effetto é apprezzabile soprattutto guardando 
l'orbita di taglio; è ora facile vedere che essa non 
giace più su di un piano ma viene deformata dall'a- 
zione della Luna che ha un'orbita inclinata di circa 5 
gradi rispetto al piano dell'eclittica (vedi Fig. 4). 




Fig. 4: Deformazione dell'orbita terrestre dovuta 
alla presenza della Luna (Tasse z e' stato 
enfatizzato per amplificare l'effetto e renderlo 
maggiormente visibile). 



CONCLUSIONI 

La trattazione di modelli matematici é un'attività' di 
cui é imbevuta tutta la tecnologia moderna. Essa ha 
un'importanza cruciale per individuare le caratteri- 
stiche dei fenomeni e per essere in grado di control- 
larli adeguatamente. Nei prossimi numeri continue- 
remo il nostro cammino e utilizzeremo i concetti qui 
esposti per estenderli a situazioni più complesse e 
rilevanti. Inoltre, invito tutti coloro i quali vogliano 
contribuire con suggerimenti e idee a contattarmi 
direttamente per mezzo dell'indirizzo di posta elet- 
tronica citato sotto. 

Per maggiori informazioni sui prodotti della fami- 
glia MATLAB potete consultare il sito di The 
Math Works {www. mathworks.it). Suggerisco a tutti 
di dare un'occhiata ad una porzione del sito web 
chiamato "MATLAB Centrar (www.mathworks.com 
/matlabcentral/). Esso riporta innumerevoli esempi di 
uso di MATLAB in una varietà molto vasta di disci- 
pline tecnico scientifiche. 

Fabrizio Sara 
(fabrizio.sara@mathworks . it) 
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^Applicazioni con interfacce avanzate. 

Effetti speciali 
sui Form 




isual 
Basic 



In questo appuntamento utilizzeremo le API di Windows 
per aggiungere nuove features ai Form, in particolar modo 
vedremo come realizzare delle form trasparenti e di 
dimensioni e forme non necessariamente standard. 



Le API (Application Programming Interface) di 
Windows sono i "blocchi" con i quali si co- 
struiscono le applicazioni Windows-based. Le 
funzioni dell' API sono supportate sia dai sistemi 
operativi a 32-bit che dai sistemi operativi a 64-bit, in 
parole povere sono utilizzabili sia da Windows 98 
che da Windows Server 2003. Le API sono tante e 
possono essere usate per svariati scopi. Esse sono or- 
ganizzate in categorie, per esempio la categoria che a 
noi principalmente interessa in questo appuntamen- 
to è la categoria regione (region) che contiene le fun- 
zioni per creare e gestire delle regioni (rettangoli, po- 
ligoni ecc.) sullo schermo. 

Le funzioni della categoria regione, per esempio, 
possono essere usate per rendere i form trasparenti, 
per dare alle finestre una forma particolare (poligo- 
nale, ovale, con buchi ecc.), mentre le funzioni di al- 
tre categorie, come Windows Function e Brush Func- 
tions, possono essere usate per dotare la finestra di ef- 
fetti speciali (compressione, espansione, comparsa 
della finestra dall'alto ecc.) , per capirci un po' come 
siamo abituati con ambienti quali Flash, Power Point 
ecc. Noi, naturalmente, descriveremo solo alcune 
funzioni dell' API e come applicazione realizzeremo 
un visualizzatore di immagini simile a quello presen- 
te in Windows XP. In particolare in questo appunta- 
mento analizzeremo i seguenti argomenti: 

1. la sintassi di alcune funzioni dell' API; 

2. descrizione sommaria degli oggetti della libreria 
MsForms 2.0; 

3. realizzazione di una finestra di forma rotonda; 

4. introduzione all'applicazione "Visualizzatore Imma- 
gini" ' . 



LE FUNZIONI DEFINITE 
NELLA CATEGORIA REGION 

Come già in precedenza accennato, la categoria Region 
include le funzioni dell' API che permettono di mani- 
polare i Form. Le funzioni principali della categoria Re- 



Funzione 


Descrizione sommaria 


CombineRgn 


Combina due regioni e memorizza il 
risultato in una terza regione 


CreateEllipticRgn 


Crea una regione ellittica 


CreateElliptic 
Rgnlndirect 


Crea una regione ellittica definita 
attraverso una struttura Rect (rettangolo) 


CreatePoly gonRgn 


Crea una regione poligonale 


CreatePoly 
PolygonRgn 


Crea una regione fatta di una serie di 
poligoni 


CreateRectRgn 


Crea una regione rettangolare 


CreateRectRgn 
Indirect 


Crea una regione rettangolare definita 
attraverso una struttura Rect 


CreateRound 
RectRgn 


Crea una regione rettangolare con 
spigoli rotondi 


EqualRgn 


Controlla se due regioni sono uguali 


ExtCreateRegion 


Crea una regione in base ad un altra 
regione e a dei criteri di conversione 


FillRgn 


Riempie una regione usando uno 
specifico pennello 


FrameRgn 


Disegna il bordo di una regione usando 
uno specifico pennello 


InvertRgn 


Inverte il colore di una regione 


OffsetRgn 


Muove una regione di uno specifico Offset 


PaintRgn 


Colora una regione usando il pennello 
selezionato 


PtlnRegion 


Determina se un punto è in una regione 


RectlnRegion 


Determina se la parte di un rettangolo è 
dentro il bordo di una regione 


SetPolyFillMode 


Specifica il tipo di riempimento per un 
poligono 


SetRectRgn 


Converte una regione in una regione 
rettangolare 



API 



\/%\ Le caratteristiche 
l^^l dell'API sono rac- 
chiuse in delle DLL 
(dynamic-lìnk library) 
ovvero file che conten- 
gono procedure, fun- 
zioni ecc. Esse sono 
caricati e collegati alle 
applicazioni durante 
l'esecuzione. Il modo 
migliore per includere 
nei progetti Visual Ba- 
sic le caratteristiche 
dell'API è utilizzare 
l'applicazione Apiload. 
exe (Visualizzatore 
API). 



Tab. 1: Funzioni definite all'interno della categoria 
Region 



http: //www. ioprogrammo.net 



t t 



2 



3 ►►► 105 




Visual 

Basic 



gion sono brevemente descritti in Tabi. Una regione 
può essere un rettangolo, un poligono o un'ellisse (o 
una combinazione di due o più di queste forme). Le re- 
gioni possono essere riempite, invertite, colorate, in- 
corniciate e usate per individuare la posizione del cur- 
sore. Le funzioni che tra poco descriveremo - e la mag- 
gior parte di quelle che permettono di gestire le carat- 
teristiche grafiche del sistema - appartengono alla li- 
breria GDI32.dll (Graphical Device Interface). 
La GDI32.dll comunica con le applicazioni Windows- 
Based attraverso la GDI (Windows Graphics Device Inter- 
facce) e con i driver della stampante attraverso la DDI 
(Device Driver Interfacce). 

Le funzioni che utilizzeremo nei nostri esempi sono le 
seguenti: 



ta Thandle della regione risultato. Il parametro nCom- 
bineMode stabilisce come saranno combinate le due re- 
gioni, a tal proposito di utile supporto può essere la 
Tab. 2. 

Nei paragrafi che seguiranno descriveremo alcune 
funzioni che non appartengono alla categoria Region 
ma che sono di fondamentale importanza per la ge- 
stione delle finestre che implementeremo. 

LA FUNZIONE CHE 
DISEGNA LA FINESTRA 

Public Declare Function SetWindowRgn Lib "user32" 

(ByVal hWnd As Long, ByVal hRgn As Long, ByVal 
bRedraw As Boolean) As Long 



Metodo ScaleX 
e ScaleY 

ScaleX e ScaleY 



Ó 



servono per con- 
vertire il valore del- 
l'ampiezza e dell'altez- 
za di un oggetto in ba- 
se alle unità di misura 
specificate attraverso 
la proprietà ScaleMo- 
de. La sintassi di Sca- 
leX è la seguente: og- 
getto. ScaleX (larghez- 
za, da-scala, a-scala), 
il secondo ed il terzo 
parametro devono es- 
sere i valori ammessi 
per la proprietà Scale- 
Mode. 



Public Declare Function CreateRectRgn Lib "gdi32" 

(ByVal XI As Long, ByVal Yl As Long, ByVal X2 As 
Long, ByVal Y2 As Long) As Long 

Come specificato evidenziato in Tab.l questa funzione 
permette di creare una regione rettangolare in base ai 
valori dei seguenti parametri: XI, Yl, X2, Y2. Essi rap- 
presentano rispettivamente le coordinata x e y del pun- 
to superiore sinistro e del punto inferiore destro del ret- 
tangolo che verrà disegnato. 

Public Declare Function CreateEllipticRgn Lib "gdi32" 

(ByVal XI As Long, ByVal Yl As Long, ByVal X2 As 
Long, ByVal Y2 As Long) As Long 

Anche per questa funzione le coordinate rappresenta- 
no un rettangolo, ovvero quello che contiene l'ellisse 
che sarà disegnata, quindi il significato dei parametri è 
analogo a quello della funzione analizzata in prece- 
denza: 

Public Declare Function CombineRgn Lib "gdi32" (ByVal 
hDestRgn As Long, ByVal hSrcRgnl As Long, ByVal 
hSrcRgn2 As Long, ByVal 
nCombineMode As Long) As Long 

Questa funzione crea una regione combinandone altre 
due, hSrcRgnl è Thandle della prima regione, hSrcRgn2 
è Thandle della seconda regione, hDestRgn rappresen- 



Costante 


Valore 


Effetto sulla terza regione 


RGN_AND 


1 


La terza regione è T intersezione delle 
altre due 


RGN_COPY 


2 


Crea una copia della regione 
identificata da hrgnSrcl 


RGN_DIFF 


3 


La terza regione è formata dalle parti 
di hrgnSrcl che non sono parti di 

hrgnSrcl 


RGN_OR 


4 


La terza regione è l'unione delle due 
regioni 


RGNJCOR 


5 


La terza regione è l'unione delle due 
regioni eccetto le parti sovrapposte 



Tab. 2: Costante che specifica la modalità di 
visualizzazione della terza regione. 



Questa funzione, a differenza delle altre, è classificata 
nella categoria "tracciare e dipingere" (Painting e 
Drawing). Essa imposta la Window Region (regione di 
una finestra) cioè Tarea dentro la finestra in cui il siste- 
ma permette il drawing. Naturalmente il sistema non 
mostra le parti di finestra fuori della Window Region. 
Il significato dei parametri è il seguente: hWnd identi- 
fica la finestra che è stata impostata; hRgn identifica la 
regione interna alla finestra che si sta definendo (se hR- 
gn è nuli anche la Window Region assumerà valore nuli); 
bRedraw è un valore di tipo Boolean che specifica se il 
sistema ridisegnerà la finestra dopo averla impostata, 
solitamente, se la finestra è visibile, questo valore è im- 
postato su True. 

LE FUNZIONI PER 
CONTROLLARE IL MOUSE 

Allorché si disegnano finestre di forma diversa da 
quella nativa, per controllare i messaggi di input pro- 
venienti dal mouse, conviene usare delle funzioni del- 
l' API. Questo perché in generale, nelle finestre di for- 
ma non canonica, la barra del titolo (la porzione d'in- 
terfaccia in cui sono presenti i controlli che permettono 
lo spostamento e il ridimensionamento del form) viene 
nascosta. Le funzioni che possono essere utilizzate a tal 
fine sono le seguenti: 

Private Declare Function SendMessage Lib "user32" Alias 
"SendMessageA" (ByVal hWnd As Long, ByVal wMsg 
As Long, ByVal wParam As Long, 
IParam As Any) As Long 

Private Declare Function ReleaseCapture Lib "user32" () 

As Long 

La ReleaseCapture appartiene alla categoria "Mouse In- 
put". Questa permette di catturare gli input provenien- 
ti dal mouse. La ReleaseCapture è senza parametri. 
La SendMessage, invece, appartiene alla categoria Mes- 
saggi (Message and Message Queue), essa invia un mes- 
saggio ad una finestra o ad un insieme di finestre ed 
aspetta che questo venga elaborato. I parametri della 
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funzione sono i seguenti: 

• hWnd: Y identificatore della finestra di destinazio- 
ne; 

• wMsg: il messaggio da spedire; 

• Wparam e Lparam: rispettivamente il primo e il 
secondo parametro del messaggio. 

Infine per eliminare gli oggetti creati useremo la se- 
guente funzione. 

Public Declare Function DeleteObject Lib "gdi32" 

(ByVal hObject As Long) As Long 

Questa funzione elimina l'oggetto associato ad un ele- 
mento grafico (pen, brush,font, bitmap, region, ecc.). 



LA LIBRERIA MSFORM2 

La MsForm2 library (FM20.dll) contiene i controlli che 
ampliano le caratteristiche di alcuni elementi nativi di 
Visual Basic come il Frame, il CommandButton, l'image 
ecc. Per esempio, sia il Frame che il CommandButton di 
MsForml possono essere riempiti con un'immagine o 
con un colore. I controlli di MsForml, rispetto ai con- 
trolli nativi, non hanno una finestra propria (sono Win- 
dowLess) per questo non sono adatti per alcune tecni- 
che di programmazione (come il subclassing). 

LA PRIMA FINESTRA 
DI FORMA ROTONDA 

Per applicare i concetti esposti implementeremo un 
semplice esempio; in particolare costruiamo il form ro- 
tondo mostrato in Fig.l. 

Per far ciò dobbiamo creare un nuovo progetto con un 
form e su di esso dobbiamo inserire una label C'Entra 
nel mio negozio"), un oggetto Shape (di tipo circlé) e un 





Fig. 1: Il Form del primo esempio in fase di 
progettazione. 



Fig. 2: Il Form durante l'esecuzione, sullo sfondo il 
desktop di Windows XP. 



CommandButton della libreria MsForml. I colori e le im- 
magini del form e dei suoi elementi li impostiamo at- 
traverso le finestre delle proprietà. Nella parte dichia- 
rativa del form dobbiamo inserire, tra l'altro, la defini- 
zione delle funzioni descritte in precedenza, cioè di 
CreateEllipticRgn, CreateRectRgn, CombineRgn, SetWin- 
dowRgn, SendMessage, ReleaseCapture, DeleteObject. Suc- 
cessivamente alla definizione delle funzioni dobbiamo 
inserire il seguente codice: 

Dim iden As Long 

Private Const RGN_DIFF = 3 

Private Const RGN_AND = 1 

Private Function Crearegione() As Long 
Dim RegCombinate As Long 
Dim NuovaRegione As Long 
Dim regForm As Long 

regForm = CreateRectRgn(0, 0, Width, Height) 
RegCombinate = CreateRectRgn(0, 0, 0, 0) 
iden = CombineRgn(RegCombinate, RegCombinate, 

regForm, RGN_DIFF) 
NuovaRegione = CreateEllipticRgn(74, 108, 464, 498) 
iden = CombineRgn(RegCombinate, RegCombinate, 

NuovaRegione, RGN_AND) 
Crearegione = RegCombinate 

End Function 

La funzione Crearegione serve per dare alla finestra la 
forma circolare. La Crearegione per realizzare ciò prima 
combina (con nCombineMode =RGN_DIFF) una regio- 
ne che copre completamente il form con una regione 
vuota e poi interseca (con nCombineMode =RGN_AND) 
il risultato con una regione circolare. Facciamo notare 
che quando si imposta la differenza (RGNJDIFF) tra 
una regione vuota e una piena resta solo la piena. Le 
coordinate dei due punti, necessari per creare un ret- 
tangolo che copra tutto il form, sono stati posti sullo 
spigolo superiore (0,0) e sullo spigolo inferiore destro 
del form (Width, Height). 

Attenzione, però, a non modificare i valori di default 
delle proprietà Scale del Form. I valori dei parametri di 




isual 
Basic 



Varie 
proprietà 



\/%\ Le proprietà Sca- 
lai leMode, ScaleHei- 
ght, Scale Width, Scale- 
Left e ScaleTop servono 
per specificare il tipo e 
la dimensione, in termi- 
ne di unità di misura, 
del sistema di coordina- 
te di un oggetto. Sca- 
leHeight imposta, o for- 
nisce, il numero di unità 
per Tasse verticale 
(ScaleWidth per quello 
orizzontale), per esem- 
pio ScaleHeight= 50 
imposta a 50 le unità 
massime per Tasse ver- 
ticale (invece di n Twi- 
ps impostati di default). 
Scale Mode, invece, im- 
posta o restituisce il ti- 
po di unità di misura 
utilizzata per un ogget- 
to (0 = definita dall'u- 
tente, l=Twip..., 7 = 
centimetri ecc.). 
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Visual 

Basic 



Librerie e tool 

["TEI La libreria da im- 
1*^1 portare nei pro- 
getti è "Preview 1.0 
Type Library". 
Microsoft Console Ser- 
vizio Fax è un tool che 
potete trovare nel CD 
di Windows XP Profes- 
sional. 



CreateEllipticRgn, cioè i punti (74, 108) e (464, 498), sono 
stati valutati in modo che l'ellisse tracciata sia una cir- 
conferenza che circondi il controllo Shape presente sul 
form. La regione della finestra viene disegnata, me- 
diante la funzione SetWindowRgn, nell r evento Form_ 
Load: 

Private Sub Form_l_oad() 

iden = SetWindowRgn(hWnd, Crearegione, True) 
End Sub 

Notate che la SetWindowRgn richiama la CreaRegione 
che restituisce Y identificatore della regione da dise- 
gnare. 

CATTURIAMO 

I MOVIMENTI DEL MOUSE 

Se ricordate bene, in precedenza abbiamo nascosto la 
barra del titolo, ragion per cui, ora, per spostare il form 
sullo schermo utilizziamo la ReleaseCapture e la Send- 
Message (con degli opportuni parametri) che inseriamo 
nella Form_MouseDown. I parametri della SendMessage 
saranno spiegati nel successivo appuntamento. 

Private Sub Form_MouseDown(Button As Integer, 

Shift As Integer, X As Single, Y As Single) 

ReleaseCapture 

SendMessage Me.hWnd, &HA1, 2, 0& 
End Sub 

Il codice relativo al bottone Chiudi è il seguente: 

Private Sub Chiudi_Click() 
Unload Me 
End Sub 

IL VISUALIZZATORE 
IMMAGINI 

In questo paragrafo accenniamo all'applicazione "Vi- 
sualizzatore Immagini" che completeremo nel successivo 
appuntamento; si tratta di un visualizzatore di imma- 
gini simile a quello incluso nei sistemi operativi Micro- 
soft (per esempio Windows XP). L'interfaccia della ver- 



sione base dell' applicazione è mostrata in Fig. 3, essa 
presenta una barra di comando costituita da una serie 
di pulsanti che permettono di sfogliare le immagini, di 
proiettarle, di ricercarle sul computer o su internet, 
d'ingrandirle ecc. Inoltre c'è d'aggiungere che le varie 
parti dell'applicazione compaiono e scompaiono con 
l'effetto espansione /compressione e che . . . analizzere- 
mo in dettaglio nel prossimo appuntamento! 
In buona sostanza abbiamo implementato un'applica- 
zione con delle caratteristiche "che suscitano invidia" 
al visualizzatore di Windows XP. 

IL VISUALIZZATORE 
DI WINDOWS XP 

Il nome completo del visualizzatore di Windows XP è 
"Visualizzatore Immagini e fax Windows" visto che 
con esso, oltre che poter gestire immagini dai formati 
più disparati, è possibile gestire i documenti di Micro- 
soft Console Servizio Fax e le immagini prodotte con 
periferiche esterne come fotocamere digitali, scanner 
ecc. Il visualizzatore di Immagini e Fax è facilmente im- 
portabile su un form Visual Basic (però non è altrettan- 
to facile controllarlo). 




Fig. 4: Il visualizzatore immagini di Windows XP. 

La libreria da importare nei progetti è "Preview 1.0 Ty- 
pe Library". Microsoft Console Servizio Fax è un tool 
che potete trovare nel CD di Windows XP Professional. 




QQ0Q r^Oil^OT 



Fig. 3: Il Form del visualizzatore di immagini in 
fase di progettazione. 



CONCLUSIONI 

La finestra di forma rotonda che abbiamo presentato 
può essere la maschera principale di una vostra ap- 
plicazione, naturalmente essa va corredata con i pul- 
santi che permettono di avviare le altre parti dell'ap- 
plicazione. 

Il progetto che presenteremo nel successivo appunta- 
mento è un Visualizzatore di Immagini con molte sor- 
prese. In parallelo illustreremo come attivare, da un 
progetto Visual Basic, il Visualizzatore di Immagini di 
Windows XP. 

Massimo Autiero 
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Ambienti 
renderizzati 



parte quarta ► Lightwave 

Roberto Lombardo 



Ultimiamo il nostro modello con il texturing del mobilio e settando 

i parametri per il rendering finale. 



Con questo quarto e ultimo tuto- 
rial, concluderemo il nostro 
modello ultimando la texturizza- 
zione del mobilio e la definizione della 
scena finale per il rendering. Questa 
serie di tutorial mira a fornire una cono- 
scenza di base sul procedimento 
costruttivo di un modello/scena di que- 
sto genere, realizzando il prodotto fina- 
le tramite una divisione del lavoro in 



passaggi intermedi. Parliamo quindi 
della definizione/modellazione della 
stanza base "grezza", dei suoi partico- 
lari, del mobilio e oggetti di contorno. 
Stesso procedimento per la fase di tex- 
turing. Nel nostro caso la stanza è 
molto semplice, nei progetti più com- 
plessi questa metodologia di lavoro ci 
verrà in aiuto per un'ottima organizza- 
zione del processo produttivo, specie 



se bisogna realizzare molti ambienti. In 
questo ultimo tutorial vedremo nel det- 
taglio la texturizzazione della credenza, 
della poltroncina, la mensola, i quadri e 
le fonti luminose (lampadario e appli- 
ques). Completato questo passaggio 
imposteremo le luci in scena ed ese- 
guiremo il rendering finale in 2 diverse 
riprese di camera. Non ci resta che ini- 
ziare con... 



w 1-2-3 La credenza 



In figura 1 possiamo vedere 
la credenza creata nel 
numero precedente, un 
oggetto molto semplice che 
contribuirà a rendere più 
realistica la stanza che stia- 
mo realizzando. A quest'og- 
getto applicheremo una tex- 
ture di tipo legno che verrà 
"mappata" in modo planare 
sui vari assi del nostro 



oggetto: x,y e z.. Non 
occorre, in questo caso, ren- 
dere la texture tailizzabile, 
possiamo realizzarla diretta- 
mente proporzionale alle 
dimensioni della credenza, in 
modo da poter aggiungere 
dettagli e "sporco" in alcuni 
punti precisi del modello. In 
figura 2 possiamo vedere la 
texture come viene applicata 
sul modello. 

In figura 3 abbiamo le textu- 
re impiegate in questo mo- 
dello e un render di prova 





del solo oggetto, possiamo 
notare 2 versioni della stes- 
sa texture, una a colori e 
l'altra in toni di grigio; que- 
st'ultima versione, servirà 
per i canali di specularità, 
diffusione e bump della 
superficie, al fine di rendere 
più realistico il materiale da 
noi creato, in questo caso il 
legno. Ogni texture che 
impiegheremo in questa 
scena sarà quindi in duplice 
versione, sia a colori che in 
toni di grigio. 
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f 4-5-6 La poltroncina 



r 7-8 La mensola 




Tocca adesso texturizzare la 
poltroncina. Anche in questo 
caso parliamo di texture 
planari in 2 diverse versioni, 
color e toni di grigio. 



Per la poltroncina dobbiamo 
usare una texture di tipo 
legno per il corpo della 
stessa e una di tipo tessuto 
per il cuscino. In figura 4 
abbiamo l'oggetto grezzo, 
così come da noi creato, in 
figura 5 possiamo vedere le 
texture utilizzate per 
mappare l'oggetto e la loro 
applicazione. La resa di ogni 
oggetto dipende 
strettamente dalla texture 
principale e dalle sue 
versioni in toni di grigio; in 
tutto questo ha un ruolo 
fondamentale l'illuminazione 
scelta per il rendering finale, 
cosa che analizzeremo nel 
proseguo. L'oggetto 
texturizzato completo è 
mostrato in figura 6. 
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Anche per la mensola 
sceglieremo delle texture di 
tipo legno, mentre 
utilizzeremo una piccola 
texture metallo per i 
sostegni della stessa. 
Partiamo dalla superficie 
della mensola, in figura 7 
sono visualizzate le texture 
utilizzate, l'oggetto grezzo e 
l'asse di applicazione delle 



mappe. Per i sostegni in 
ferro utilizzeremo una 
"mappatura" cilindrica 
sull'asse y. Il risultato 
dell'oggetto texturizzato è 
visibile in figura 8. 
Volendo, possiamo inserire 
oggetti sulla mensola per 
aumentare il dettaglio e la 
resa finale dell'intera stanza 
in fase di rendering. 
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Note 

Il primo resident evil a cui si è ispirato il 
tutorial è uscito nel lontano 1996, 
creando di fatto l'attuale genere "survivr 
horror". L'intero gioco era basato su 
locazioni pre renderizzate in cui si 
muovevano personaggi poligonali 3D in 
realtime. Successivamente, visto il 
successo ottenuto, la Capcom ha 
prodotto diversi altri "episodi" per le 
varie piattaforme (l'immagine qui 
raffigurata si riferisce al terzo capitolo, 
"nemesis"). Attualmente il gioco è 
presente nella sua ultima versione su 
piattaforma GameCube di Nintendo, 
mantenendo inalterato lo stile tecnico e 
grafico di base, ma adattandosi 
naturalmente alle moderne tecnologie e 
possibilità offerte dalla macchina di casa 
Nintendo. 
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9-10 I quadri 



Altro elemento da texture 
sono i quadri, per questi uti- 
lizzeremo una texture legno 
modifica per la cornice e 
un'immagine da inserire 



come tela vera e propria. In 
figura 9 abbiamo lo schema 
delle texture usate per l'og- 
getto. Queste vengono 
"mappate" in modo planare 



© 






Co rnice del quadro 
Color+ bump ispecular +diffuse 




Te I a + bump 



sui vari assi dell'oggetto. In 
figura 10 si posso "ammira- 
re" le texture applicate 
all'oggetto e un test render 
dello stesso. Anche questo 



oggetto adesso è pronto per 
essere inserito nella scena, 
ma prima dobbiamo ultimare 
gli ultimi 2 elementi, il lam- 
padario e gli appliques. 




Dettaglio 



Test render 



M 1-1 2-1 3 II lampadario 



Questo oggetto richiede più at- 
tenzione per il texturing. Dob- 
biamo suddividerlo in più super- 
fici sulla quale andremo a tex- 
turare la stessa bitmap. In figu- 
ra 11 abbiamo la texture impie- 
gata e il corrispondente risulta- 
to in fase di rendering. Si tratta 
di una texture di tipo metallo 
con alcune modifiche per ren- 
derla tailizzabile; la stessa in 
seguito è stata riprodotta in to- 



ni di grigio per i canali di specu- 
larità, bump e diffusione della 
luce. In figura 12 possiamo ve- 
dere gli assi e la modalità di 
"mappatura", da utilizzare per 
ogni sezione del lampadario. 
Per il vetro dobbiamo settare il 
colore di base (un colore chiaro 
tendente al giallo pallido), una 
trasparenza del 10 %, diamo 
un fattore di luminosità al vetro 
stesso di circa 150% e attivia- 



color 


Schema di 
textu ring 1 

US 


bump + specular + difl 
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planare 



planare y n colore di superficie 

nero 

planare 




planare 



planare cilindrica y 

schema texturing 2 



mo un effetto glow sulla sua prova dell'oggetto per controlla- 

superficie. Fatto questo, possia- re la corretta resa delle texture 
mo eseguire un rendering di (figura 13). 



© 




Dettag I i o del 
lampadario 



112>>> Settembre 2003 



http://www.ioprogrammo.net 




Gli appliques 14 



Per gli appliques 
utilizzeremo la stessa 
texture del lampadario, 
idem per il settario del 
vetro. Un esempio del 



in figura 14. Il texturing 
deve essere eseguito con 
mappature planari per la 
base e la semplice 
superficie "vetro" per la 



rendering possiamo vederlo relativa sezione. 



15-16-17 La scena finale 



Tutto è pronto per il rende- 
ring finale, abbiamo i nostri 
oggetti completamente textu- 
rati da inserire in scena. Per il 
posizionamento delle porte e 
degli oggetti ogni utente ha 
"carta bianca". Eseguiremo il 
calcolo finale con un motore 
radiosity per aumentare il 
realismo, reso possibile grazie 
alla diffusione della luce indi- 
retta. In figura 15 abbiamo la 
scena in OpenGL cosi come si 
presenta prima del rendering. 
Iniziamo con l'impostare delle 
luci, queste devono essere di 
tipo point con un "intesity fal- 



I off" attivo (diminuzione della 
luce in base alla distanza). 
Dobbiamo sistemare una 
point per ogni punto luce 
della stanza, quindi 4 per il 
lampadario e 1 per ogni 
appliques. Posizioniamo le 
luci poco sopra la boccia di 
vetro dei punti luce, questo 
per permettere di diffondere 
la luce assieme alla boccia 
stessa. Nel caso di stanza 
troppo scura abbiamo 2 modi 
per risolvere l'inconveniente: 
l'aggiunta di luci di supporto 
che non proiettino ombre, 
anch'esse con un parametro 




di attenuazione attivato in 
base alla distanza. Queste 
posso essere di tipo point 
light posizionate strategica- 
mente in base alle zone 
d'ombra venutesi a creare, 
oppure, altra soluzione, 
importare il rendering in 



Adobe Photoshop e quindi 
lavorare sui parametri di "bri- 
ghtness" e "contrast" sino ad 
ottenere il risultato che più si 
avvicina alle nostre aspettati- 
ve. In figura 16, 17 e 18 
abbiamo tre rendering ese- 
guiti in Lightwave 7.5. 





Considerazioni 



Con quest'ultimo articolo abbia- 
mo concluso la lunga sezione 
riguardante la creazione di una 
stanza 3D pre renderizzata. 
I risultati del rendering possono 
variare, in base ad alcuni para- 
metri, da programma a pro- 
gramma, quindi, non occorre 
cercare la totale perfezione 
nella riproduzione del rendering 
da me ottenuto. Se dovessimo 
ricreare altre stanze a tema 
potremmo riciclare alcuni dei 
componenti creati come le 
mensole o gli appliques, onde 



ridurre i tempi di produzione 
per ciò che riguarda la model- 
lazione. Un ritocco in Adobe 
Photoshop può rivelarsi neces- 
sario per ritoccare parametri 
come luminosità e contrasto ed 
effettuare piccole modifiche ed 
aggiustamenti post rendering. 
La resa finale della scena 
dipende fortemente dalle textu- 
re impiegate per la definizione 
della stessa nonché da ogni 
oggetto presente. Non vi resta 
che lanciare il rendering, ci 
vediamo al prossimo tutorial. 
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Advanced Edition ► ► ► ► ► ► ► ► 




Pocket PC 



^ Interfacciamento di applicazioni mobili con moduli di rilevazione posizionale 

Moduli GPS 



e Pocket PC 



Molte aziende hanno cominciato a sperimentare i vantaggi 
del rilevamento di coordinate geografiche in loco, con Pocket 
PC + modulo GPS, con successivo invio ad un Application 
Server in remoto. Esploriamo il mondo dei moduli GPS 
e sperimentiamo il loro interfacciamento con un Pocket PC. 



File sul CD 



\soft\codice 
\Merge_RDA.zip 



File sul Web 

www.ioprogrammo.net/ 
files/72/Merge_RDA.zip 



Requisiti 

HARDWARE: Pocket PC 

(dispositivo Win- 
dows CE Based), Com- 
puter con almeno pro- 
cessore Pentium II e 
128 MB di memoria, un 
modulo GPS per Po- 
cket PC. 

SOFTWARE: Windows 
98 SE /2000/XP, US 
(oppure PWS-Personal 
WEB Server con Win- 
dows 9x), SQL Server 
2000 con Service Pack 

1 o superiore, SQL Ser- 
ver CE 2.0, Embedded 
Visual Tools. 



Nel presente articolo tratteremo la progettazio- 
ne di una applicazione su Pocket PC che ci 
permetterà di comunicare con un modulo 
GPS. La comunicazione permetterà, in particolar mo- 
do, di rilevare, via satellite, le informazioni di longitu- 
dine e latitudine relative alla posizione corrente. Sare- 
mo anche in grado di rilevare dal satellite informazio- 
ni di altra natura, come ad esempio Torà esatta. Lo sco- 
po che ci proponiamo in questo e nel prossimo artico- 
lo, è quello di progettare due applicazioni distinte ma 
in comunicazione tra loro: 

• L'applicazione client, su Pocket PC: abbiamo già 
detto che questa applicazione permetterà di rileva- 
re le coordinate dal satellite tramite il modulo GPS 
e inviarle alla parte Server; 

• L'applicazione Server: rileva le informazioni di 
posizione inviate dal palmare. Le coordinate rice- 
vute permetteranno al Server di sapere dove si tro- 
vi un operatore o un veicolo che utilizzi Y applica- 
zione client, e di individuarlo su una mappa. 

L'architettura del sistema è rappresentata in Fig. 1. Dal- 
lo schema, possiamo notare gli attori principali del si- 




Fig. 1: Architettura del sistema relativo alle due 
applicazioni del progetto. 



stema: il client pocket PC su cui è installata la nostra 
applicazione, che prende le coordinate dal satellite, e 
l'application Server a cui le coordinate vengono invia- 
te. È appena il caso di precisare che possiamo inviare le 
coordinate al Server utilizzando diverse tecnologie di 
comunicazione; nell' architettura di Fig. 1 abbiamo pre- 
so in considerazione le tecnologie GPRS, GSM e LAN. 
Nell'applicazione supporremo di avere una connessio- 
ne LAN diretta tra il palmare e il Server. In questo ca- 
so, i dati rilevati dal satellite saranno memorizzari "in 
locale" sul Pocket PC; una volta giunti nella rete LAN 
dove è installato il Server, i dati saranno sincronizzati 
connettendo il Pocket PC alla rete stessa. L'ipotesi di 
utilizzo di una connessione locale ha lo svantaggio che 
il palmare non potrà comunicatre in real-time la posi- 
zione del veicolo. Lo scopo del presente lavoro è solo 
quello di costruire una applicazione che permetta di 
prelevare informazioni dal GPS e trasmetterle in qual- 
che modo ad un Application Server; ci proponiamo di 
trattare in un altro articolo lo studio delle metodologie 
con le quali attivare una connessione GPRS o GSM con 
il palmare, e usare tale tecnologie per rendere "vera- 
mente mobili" le nostre applicazioni. 

MECCANISMO 

DI SCAMBIO DATI 

A questo punto è importante specificare la metodolo- 
gia con la quale i due attori dell'applicazione possano 
scambiarsi i dati. Il cuore del sistema che permetterà lo 
scambio dei dati sarà SQL Server CE. Sul Server instal- 
leremo SQL Server, su cui progetteremo il database che 
conterrà la tabella in cui memorizzeremo le coordinate 
corrispondenti alle diverse posizioni relative al veicolo. 
Il passo successivo sarà quello di effettuare la pubbli- 
cazione del Database secondo la tecnica decritta in un 
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precedente articolo. La pubblicazione ci consentirà di 
costruire una replica del database del Server sul pal- 
mare tramite la procedura di sottoscrizione. Ricordia- 
mo che la procedura di sottoscrizione e successive sin- 
cronizzazioni dati tra Server e client Pocket PC potran- 
no avvenire solo se sul palmare avremo installato SQL 
Server CE 2.0. Avvenuta la fase di sottoscrizione, la lo- 
gica di funzionamento dell'applicazione palmare sarà 
quella di attivare un thread secondario (in back- 
ground) rispetto al thread principale dell'applicazione, 
il quale si occuperà della rilevazione e lettura dei dati 
provenienti dal satellite, dalla porta seriale del palma- 
re a cui è collegato il modulo GPS, e scrivere i dati sul- 
l'istanza locale del database. Precisiamo da subito che 
gli istanti in cui il thread secondario campionerà i dati 
dal GPS potranno essere gestiti da codice. L'applica- 
zione sul palmare disporrà poi della logica necessaria 
alla sincronizzazione dei dati con il server di Database. 
Possiamo anticipare che lo scambio dati tra application 
Server e client pocket PC avviene tramite tecnologia 
Merge Replication di SQL Server. Inoltre, ogni volta che 
una sincronizzazione dati tra palmare e server di Data- 
base è andata a buon fine, l'application server avrà i 
dati aggiornati delle posizioni occupate dal veicolo in 
un dato periodo. 

ARCHITETTURA DELLA 
APPLICAZIONE CLIENT 

Lo scopo che ora ci proponiamo è quello di descrivere 
T architettura della applicazione client sul palmare in 
modo da evidenziare gli oggetti necessari per il corret- 
to funzionamento 







del sistema di posi- 
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Fig. 2: L'architettura Client. una visione d'insie- 
me per cui l'intera 
logica di funziona- 
mento possa essere ricostruita in modo semplice e sen- 
za problemi. 

L'applicazione sul palmare si configura come una ap- 
plicazione multithread; due sono i thread che lavoreran- 
no ad un certo istante sul palmare: 

• Il thread dell'applicazione principale attivato in fa- 
se di invocazione del programma. 

• Il thread secondario che gestisce la comunicazione 
diretta con il modulo GPS e ne legge i dati ricevuti 
dal satellite. 



senta proprio il thread del punto 2. Esso è attivato dal 
metodo Initialise dell'oggetto GPSManager. In partico- 
lare, GSPThread si serve dell' oggetto GPSReader per 
prelevare le coordinate (e non solo) dal GPS. Nello 
schema di architettura di Fig. 2, possiamo notare un 
Buffer che abbiamo indicato con il nome di "Lista Coor- 
dinate Safe"; nella corrente implementazione, questa li- 
sta simula un database in locale su cui inseriamo dei 
dati. La differenza sostanziale è che la lista è creata a 
run-time e, una volta chiusa l'applicazione, non ri- 
marrà traccia delle posizioni rilevate. Ad ogni modo ci 
permetterà di fare ugualmente importanti considera- 
zioni progettuali e di programmazione. Infatti, questa 
lista è utilizzata non solo dal thread GPSThread per 
scrivere le coordinate rilevate dal GPS, ma anche dal 
thread dell'applicazione principale per prelevare tali 
coordinate e mostrarle all'utente. Ora stiamo per capi- 
re il motivo per cui la lista di coordinate è stata defini- 
ta "safe": dobbiamo garantire un accesso sicuro e in 
mutua esclusione sul Buffer. Chiunque di voi abbia 
avuto a che fare con le applicazioni relative alla "pro- 
grammazione concorrente" avrà subito capito che ci 
troviamo di fronte al classico problema dei "Lettori e 
degli Scrittori": in particolare dobbiamo sincronizzare i 
thread in modo tale che quando si inizia una operazio- 
ne di lettura, non possa essere eseguita una operazione 
di scrittura e viceversa. Il Problema viene risolto con 
l'ausilio dei "semafori" che permettono di disciplinare 
l'azione di più thread su una risorsa condivisa. Questi 
oggetti sono presenti anche in Windows CE così come 
la gestione dei thread. 

APPLICAZIONE GPSUTILITY 

L'applicazione GPSUtility si configura come un'appli- 
cazione In Embedded Visual C++ 3.0 Dialog Based. In 
Fig. 3 è rappresentata le maschera principale dell'ap- 
plicazione. In Fig. 4 abbiamo evidenziato, con un'ellis- 
se nel Project Explorer, la classe CGPSUtilityDlg asso- 
ciata alla risorsa Dialog di 
Fig. 4. In quest'ultima classe 
possiamo notare la presen- 
za della variabile membro 
privata m_gpsManager, 
istanza della classe CGPS- 
Manager. Questa classe for- 
nisce i metodi atraverso i 
quali inizia il processo di 
lettura delle coordinate rile- 
vate dal satellite. Nella ma- 
schera di Fig. 3 possiamo 
notare i seguenti tasti: 
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Start GPS 












Coordinate Correnti 












Stop GPS 
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Fig. 3: La maschera 
con le diverse funzion 




Pocket PC 



Application 
Server 



r^sH Nel prossimo arti- 
|On colo, in cui ci oc- 
cuperemo anche del- 
l'Application Server e 
della interazione con 
un Pocket PC, aggiun- 
geremo all'applicazio- 
ne client la classe di 
accesso ai dati e di sin- 
cronizzazione. 
Non l'abbiamo fatto 
ora solo perchè ci sia- 
mo voluti concentrare 
sugli aspetti dell'archi- 
tettura necessari per 
l'interfacciamento con 
un qualunque modulo 
GPS. Il primo oggetto 
che prendiamo in con- 
siderazione è il GPS- 
Manager. Tale oggetto 
si configura come 
quello che gestisce l'i- 
nizio e la fine del pro- 
cesso di comunicazio- 
ne con il modulo GPS. 
A tal fine, GSPManager 
dispone dei metodi 
Initialise e Closedown. 



Start GPS: viene fatto partire il thread secondario 
per la lettura delle coordinate dal modulo GPS. La 
funzione di gestione dell'evento click è molto sem- 
plice: 



L'oggetto GPSThread nello schema di Fig. 2, rappre- 



m_gpsManager.Initialise(); 
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Pocket PC 



Coordinate 

Le coordinate rile- 
vate dal GPS pos- 



Ó 



sono essere facilmente 
lette progettando una 
applicazione per Po- 
cket PC. La rilevazione 
continua delle coordi- 
nate permette di me- 
morizzarle e inviarle ad 
una application server 
per consentire in ogni 
momento la conoscen- 
za della posizione di un 
veicolo o di un operato- 
re e per diversi scopi. 
Uno degli scopi potreb- 
be essere quello rileva- 
re la posizione attuale 
di diverse ambulanze 
e, nel caso di un soc- 
corso urgente, contat- 
tare direttamente quel- 
la più vicina al luogo di 
interesse. 



GPS 

r^n GPS (Global Posi- 
l'C/l tioning System) 
rappresenta il sistema 
con il quale possiamo 
rilevare, con una accu- 
ratezza di circa lOOm, 
con un ricevitore ade- 
guato le coordinate dal 
sistema di satelliti in 
orbita. Anche i Pocket 
PC possono essere uti- 
lizzati per connettersi 
ad un modulo GPS 
esterno sia attraverso 
il connettore seriale 
che tramite altra inter- 
faccia. 



Coordinate Correnti: vengono mostrate in una fi- 
nestra di dialogo le ultime coordiante rilevate. 
L'implementazione del metodo di gestione dell'e- 
vento click è la seguente: 

CCoordinate ce; 

if(m_gpsManager.GetCoordinate(cc)) { 
AfxMessageBox(_T("l_atitudine = ") + 

cc.GetLatitudineQ); 
AfxMessageBox(_T("l_ongitudine = ") + 

cc.GetLongitudineO); 
AfxMessageBox(_T("Ora = ") + cc.GetOraQ);} 
else { 
AfxMessageBox(_T("Non ci sono coordinate al 

momento!")); } 



Possiamo notare la di- 
chiarazione di un oggetto 
di tipo Coordinate. Que- 
sta classe è molto sempli- 
ce e permette di modella- 
re l'informazione rilevata 
dal satellite: le sue pro- 
prietà saranno valorizza- 
te all'atto della chiamata 
del metodo GetCoordina- 
te(cc) sull'istanza m_gps- 
Manager; rimandiamo al 
codice sul CD per la strut- 
tura della classe Coordi- 
nate. 



- Jfj^ GPS Utility classes! 

E-"!* CCoordinate 
S-"T* CG PS Manager 
B-V CGI PS U tilit^iApp __ 
B^g jJGJ PS U UlityDjT^ ^: 

+ CG PS Utility Dlg(CWnc 

% DoDataEKchange(CD 

% 0nButton1() 

% 0nButton2() 

% 0nButton3() 

%JMlffi§logJ) 

m_gpsManager 

■9^~rin_hlcon 

S--"C CThread 
S-"C GPS_ACQ_DATA 
S--"lS GPSReader 
m-^Z GPSThread 
S--"l3 I GPS Manager 



Fig. 4: Oggetti della 
classe CGPSUtilityDIg. 



• Stop GPS: termina il thread di rilevazione delle 
coordinate dal satellite. Il metodo associato al click 
è il seguente: m_gpsManager.CloseDown(); 

CLASSI GPSMANAGER 
E GPSTHREAD 

In Fig. 5, possiamo notare la struttura di questa classe. 
In particolare, possiamo notare la presenza di due og- 
getti come variabili membro di classe: 

GPSThread m_gpsThread: rappresenta il thread se- 
condario, l'esecuzione del quale fa iniziare il processo 
di lettura delle coordinate dal GPS se esso è collegato e 
alimentato; 

ListaCoordinateSafe m_listaCoordinateSafe: rappre- 
senta l'implementazione del contenitore delle informa- 
zioni rilevate dal thread e gestita in maniera safe. 



Nel progetto sviluppato 
abbiamo costruito in 
Windows CE lo schema 
di principio di un Thread; 
abbiamo chiamato questa 
classe CThread. La classe 
CThread rappresenta la 
classe base da cui deriva- 



B-*C CG PS Manager 

•■ + CGPSManager() 

• + "CGPSManagerO 

• % CloseDownQ 

• ^ GetCoordinate(CCoordina 
- lnitialise[| 
•9$ m_gpsThread 



Fig. 5: Struttura della 
classe CGPSManager. 



re tutti i nostri thread che effettuano operazioni speci- 
fiche. Per forzare questo comportamento abbiamo di- 
chiarato dei metodi virtuali. Ecco come si presenta il fi- 
le di intestazione della classe: 

class CThread { 
public: 

CThreadQ; 

virtual ~CThread(); 
// Public interface 

virtual bool Start(); 

virtual bool Stop(); 

virtual DWORD SuspendQ; 

virtual DWORD ResumeQ; 
protected: 

virtual int Run() = 0; 
// Implementation 
protected: 

void Lock() const; 

void Unlock() const; 
// procedura del thread di classe 
protected: 

static DWORD WINAPI ThreadProc(LPVOID IpParameter); 
//Procedura del thread istanza 
protected: 

DWORD ThreadProcQ; 
protected: 

HANDLE m_hThread; 

bool m_fEndThread; 

mutable CRITICAL_SECTION m_cs; }; 

La classe CThread possiede un membro mJiThread, 
che rappresenta un handle al processo, che verrà effet- 
tivamente creato nel costruttore della classe tramite 
un'apposita API del sistema operativo Windows CE. 
Per garantire l'accesso sicuro alle proprietà del thread è 
necessario usare un semaforo rappresentato dall'og- 
getto m_cs di tipo CRITICAL_SECTION. Gli oggetti di 
tipo CRITICAL_SECTION permettono di costruire un 
protocollo sicuro per l'accesso in modo sincronizzato a 
parti di codice che sono condivise da più processi. 
Prima di poter accedere a qualunque risorsa condivisa, 
è necessario chiedere il permesso per entrare in sezio- 
ne critica e bloccarsi fino a quando non ne ottengo il di- 
ritto. Dopo aver ottenuto l'accesso nella alla sezione 
critica, e aver utulizzato le risorse condivise, è necessa- 
rio rilasciare l'uso della la risorsa per non bloccare 
eventuali altri processi che ne richiedessero accesso. 
Questo protocollo di "buone maniere" è ottenuto con i 
metodi Lock e UnLock di cui forniamo di seguito l'im- 
plementazione: 

void CThread: :Lock() const 

{ ::EnterCriticalSection(&m_cs); } 

void CThread: :Unlock() const 

{ ::LeaveCriticalSection(&m_cs); } 

Dal codice notiamo che si utilizzano le funzioni globa- 
li EnterCriticalSection e LeaveCriticalSection per ottenere 
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questo risultato, passando per riferimento l'oggetto 
m_cs. Tutte le funzioni relative alla classe Thread inizie- 
rano con Lock e finiranno con UnLock, proprio per ri- 
spettare questo protocollo di sincronizzazione tra pro- 
cessi. Vediamo ora il costruttore della classe: 

CThread::CThread() { 

::InitializeCriticalSection(&m_cs); 
m_hThread = NULL; 
m_fEndThread = false; } 

Come possimo notare dal codice, nella lista viene ini- 
zializzato l'oggetto della sezione critica. L'handle del 
thread viene posta a NULL e la variabile mJEndThread, 
che verifica che, se il thread è in esecuzione, è posta a 
false. La effettiva creazione dell'istanza del thread e la 
sua esecuzione viene attivata con la funzione starti) se- 
guente: 




Con l'ausilio della funzione CreateThread possiamo co- 
struire l'istanza del thread; alla funzione passiamo an- 
che il puntatore alla funzione che dovrà essere esegui- 
ta ripetutamente dal thread fino a quando non sarà 
bloccato con la funzione Stop. In ultima analisi il pro- 
getto della classe è stato fatto in modo tale che la fun- 
zione ThreadProc richiamerà a sua volta l'implementa- 
zione del metodo Run(). Quando dovremo costruire th- 
read personalizzati, sarà dunque necessario preoccu- 
parci di implementare il metodo Run(). Alla luce delle 
considerazioni sulla classe CThread, costruiamo la clas- 
se CGPSThread che la estende. 

La classe utilizza un oggetto della classe m_GpsReader 
per aprire la porta di comunicazione e interfacciarsi 
con il moduolo GPS. Nella funzione di Starti) possiamo 
notare che viene aperta la porta seriale di connessione 
al GPS; una volta che tale operazione è andata a buon 
fine, possiamo chiamare il metodo starti) sul thread in 
modo che possa iniziare il processo di rilevazione del- 
la coordinate. Con il metodo Stop chiudiamo la porta di 
connessione al GPS e blocchiamo l'esecuzione del 
thread. Vediamo di seguito l'implementazione del me- 
todo Run(): 

int GPSThread::Run() { 
CCoordinate ce; 

m_GpsReader.ReadCordinates(cc); 
::Sleep(10Q0); 
if(m_listaCoordinateSafe->InsertPosition( 

cc.GetLatitudine(),cc.Getl_ongitudine())) { 




La logica è molto semplice: leggiamo le coordinate, in- 
vocando il metodo ReadCoordinates sull'oggetto m_ 
Gpsreader, e le scarichiamo in modo safe sulla lista del- 
le coordinate rilevate. Inoltre, se l'operazione di inseri- 
meto nella struttura dati è andata a buon fine, facciamo 
un trace nella finestra di Debug delle informazioni ri- 
levate. L'operazione di TRACE sarà effettiva solo se sia- 
mo nella modalità debug della applicazione. 



CLASSE GPSREADER 

Dallo schema di architettura di Fig. 2, abbiamo visto 
come questo modulo comunichi direttamente con il 
GPS. Vediamo in dettaglio la struttura delle informa- 
zioni che vengono lette dal modulo. Il Modulo GPS su 
cui abbiamo effettuato le nostre prove è Destinator. De- 
stinator rappresenta un modulo GPS esterno che si col- 
lega alla porta seriale del Pocket PC. 
Il Pocket PC di riferimento è un iPAQ 3970 della Com- 
paq. Per quanto riguarda la lettura dei dati da un mo- 
dulo GPS; diciamo subito che questa operazione è ot- 
tenuta utilizzando le funzioni standard della comuni- 
cazione seriale. 

Nel file di esempio contenuto nel CD-Rom allegato, ve- 
diamo l'implementazione della operazione di apertura 
della porta seriale del GPS ottenuta tramite la funzione 
OpenPort della classe GPSReader. 
La funzione OpenPort determina prima di tutto il no- 
me della porta a cui connettersi (tipicamente è la 
COMI per un GPS esterno come il nostro). È stata uti- 
lizzata la funzione CreateFile per aprire la porta; inoltre 
per poter configurare la stessa è stata utilizzata la strut- 
tura DCB. Una variabile di tipo DCB rappresenta una 
struttura che definisce i valori da impostare per con- 
trolla la porta seriale cui è collegato un dispositivo con 
cui dialogare. Seguire attentamente i valori con cui ab- 
biamo configurato la porta seriale, poiché è di vitale 
importanza per il corretto funzionamento dell'opera- 
zione successiva: la lettura dei segnali provenienti dal 
satellite. 

Non vogliamo appesantire la trattazione, per cui non 
andremo in dettaglio nella comprensione dei parame- 
tri di configurazione della porta. Diciamo solo che se 
l'operazione di apertura della porta è andata a buon fi- 
ne, verrà restituito un valore booleano true. Una volta 
che la porta seriale è stata aperta e opportunamente 
configurata, è possibile leggere il segnale proveniente 
dal satellite. I dispositivi GPS producono informazioni 
posizionali in accordo allo standard NMEA 0183. Lo 
standard NMEA è basato su linee di comando testuali. 
Ogni linea dati di comando viene definita sentenza. 
Inoltre, le sentenze sono mandate in output dal GPS in 
maniera continua. Da questo si capisce l'importanza di 
un thread per la cattura di tali informazioni. Lo stan- 
dard, inoltre, stabilisce che la velocità di trasmissione 




Pocket PC 



RMC 



\~7K\ La sentenza di ti- 
r-J] pò RMC rappre- 
senta, una particolare 
linea di caratteri che 
descrivono dati rilevati 
dal satellite. 
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Pocket PC 

Quale GPS? 

I II Modulo GPS SU 
| cui sono state ef- 
fettuate le nostre prove 
è il Destinator. Questo 
GPS viene fornito unita- 
mente al software Po- 
werLoc e a delle mappe 
geografiche che con- 
sentono di riprodurre 
del tutto le funzionalità 
dei moduli GPS installa- 
ti nelle auto. In Fig. 7 



DestinAtor 

Personal Navigation System 
♦PowerLOC 



possiamo vedere la ma- 
schera di caricamento 
iniziale del programma. 
Nelle Fig. 8 e 9 invece si 
può notare la posizione 
rilevata e visualizzata 
sulla mappa installata 
sul Pocket PC. Si può ac- 
quistare dalla casa pro- 
duttrice un SDK con il 
quale interf accia rsi con 
l'applicazione a corredo 
del Destinator. 
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L'incoveniente dell'ap- 
plicazione PowerLoc è 
che essa apre la porta 
seriale per leggere le 
coordinate dal GPS, per 
cui una nostra applica- 
zione non potrebbe 
aprirla dato che solo 
una per volta può farlo. 



Via Resistenza, Viale dell 
«detto anche > Ss 19 
Città Commenda 
CAP 87030 



dei comandi sia di 4800 Baud, ma per molti GPS pos- 
sono essere selezionate diverse velocità di trasmissio- 
ne. Un esempio tipico di sentenza è la seguente: 

$GPRMC,195531,A,5326. 986,N, 00610. 147,W,000. 0,360.0, 

170500,007. 2,W*7F 

Quella appena scritta, rappresenta una tra le possibili 
sentenze in uscita da un modulo GPS. In particolare, 
abbiamo qui rappresentato la sentenza RMC. La sen- 
tenza di tipo RMC rappresenta, quindi, una particola- 
re linea di caratteri che descrivono dati rilevati dal sa- 
tellite. In particolare, ogni sentenza inizia con il carat- 
tere $; le due lettere seguenti rappresentano Tidentifi- 
cativo del tipo di dispositivo, in questo caso "GP" in- 
dica che il GPS di riferimento è di tipo Garmin. I tre ca- 
ratteri successivi rappresentano il tipo di comando, in 
questo caso RMC. I dati nella sentenza sono separati 
da virgole. 

Ogni sentenza termina con un carattere di "*" seguito 
da un numero che rappresenta la checksum per la ve- 
rifica della correttezza della sequenza di caratteri. Il 
primo dato contenuto nella sentenza di esempio rap- 
presenta Torà in cui la posizione è stata rilevata dal sa- 
tellite nella notazione "hhmmss", ovvero in questo ca- 
so le 19:55:31. Il carattere seguente Torà di rilevazione 
della posizione serve per sapere se è buono lo stato di 
rilevazione del segnale dal satellite. Sono possibili due 
valori: 

• A: il segnale è buono. 

• V: valore di warning ovvero la rilevazione potreb- 
be essere sospetta. 

Il dato successivo 5326.986 rappresenta la latitudine 
corrente espressa in gradi nel range 0-90 gradi, minuti, 
e frazioni di minuto; in questo caso la latitudine è 53 
gradi, 26 minuti e 1/986 di minuto. La longitudine cor- 
rente, espressa nello stesso formato della latitudine, è 
00610.147. Infine, 170500 è la data di rilevazione delle 
coordinate nel formato "ggmmaa", che corrisponde al 
17 Maggio del 2000. Un altro tipo di sentenza simile al- 
la precedente, ma senza Y indicazione della data del 
giorno, è la seguente (corrispondente al comando 
GGA): 

$GPGGA,195531, 5326. 986,N, 00610. 147,W,1, 07,1. 5,24. 7 

M,54.0,M„*6° 

Rimandiamo alle specifiche dello standard NMEA per 
una esaustiva rassegna delle tipologie di comandi in 
output da un sistema GPS e il significato dei dati con- 
tenuti in ogni sentenza di comando. 

METODO DI LETTURA 
DEI DATI 

A questo punto analiziamo il metodo ReadCoordinates 
della classe GPSReader, con la quale leggiamo le sen- 



tenze provenienti dalla porta seriale appena aperta. 
La logica della funzione è quella tipica di lettura da una 
porta seriale. Innanzi tutto, viene invocata la funzione 
SetCommMask passando il riferimento allo HANDLE 
della porta COM, e specificando alcuni valori costanti 
in OR che rappresentano gli eventi che bisogna gestire. 
La registrazione di tali eventi viene fatta con il tramite 
della funzione di Windows CE WaitCommEvent. In par- 
ticolare, specificare la costante EV_RXCHAR nel meto- 
do SetCommMask vuol dire voler rilevare che un carat- 
tere è stato ricevuto sulla porta seriale e posto nel buf- 
fer. 

Dopo l'impostazione degli eventi, inizia il ciclo di let- 
tura dalla porta seriale tramite la funzione ReadFile e 
leggendo un Byte alla volta. Durante il ciclo di lettura 
viene ricostruita la sentenza che ci interessa. Nel caso 
specifico siamo interessati sia alla sentenza di tipo 
RMC che sia GGA, e abbiamo scritto due funzioni di 
parsing che prelevano le informazioni: le funzioni in 
questione sono ParseRMC e ParseGGA che vi invitiamo 
a visionare nel CD di "ioProgramo". Le funzioni in 
questione permetteranno di valorizzare gli appositi 
campi della classe di tipo Coordinate che passiamo co- 
me parametro. 
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Fig. 6: Valori di Latitudine, Longitudine e Tempo 
delle coordinate correnti. 



Per verficare che tutto funziona bene, mandiamo in 
esecuzione la nostra applicazione. Dopo aver aperto la 
porta seriale con il tasto "Start GPS", premere il tasto 
"Coordinate Correnti"; verranno visulizzate in sequen- 
za tre finestre di messaggi con i valori della Latitudine 
(Fig. 6- A), della Longitudine (Fig. 6-B) e dell'ora (Fig. 6- 
C) in cui le coordinate sono state rilevate dal satellite. 



CONCLUSIONI 

In questo primo articolo sulle applicazioni di posizio- 
namento per Pocket PC, abbiamo descritto una appli- 
cazione con cui riusciamo a catturare i dati da un siste- 
ma GPS. 

Nel prossimo articolo prenderemo le mosse da questa 
applicazione palmare per aggiungervi le funzionalità 
necessarie per l'accesso ai dati con SQL Server CE, e la 
logica di sincronizzazione. 

Inoltre, svilupperemo la parte Server in APS .NET con 
la quale potremo usare le coordinate rilevate dal satel- 
lite per visualizzarle su una mappa. Per la logica di di- 
segno su mappe geografiche ci serviremo di Map- 
Point.NET. 

Ing. Elmiro Tavolavo 
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^ Tecniche per la stesura di codice manutenibile (parte seconda) 

La qualità del 



• Il 



ice Java 




Codice 

di qualità 



In questo appuntamento illustreremo le linee guida per 
realizzare codice ben scritto e mostreremo uno strumento 
per la verifica della qualità del nostro codice. 



Nell'articolo precedente abbiamo analizzato le 
problematiche di qualità legate al concetto di 
sviluppo del software, distinguendo la qua- 
lità semantica, legata a come il software viene proget- 
tato ed organizzato, da quella sintattica, più indirizza- 
ta invece a come questo viene scritto. Concentrandoci 
sul secondo aspetto, abbiamo cercato di capire quali re- 
gole sintattiche debbano essere rispettate e quali metri- 
che si debbano utilizzare per la verifica di conformità 
del nostro codice con le regole stesse. In particolare, dal 
punto di vista delle regole da seguire per l'analisi della 
qualità sintattica del codice Java, ci siamo basati sulle 
Code Conventions fot the Java Programming Language for- 
nite dalla stessa Sun Microsystem. In questo secondo 
articolo analizzeremo le ultime regole indicate nelle Co- 
de Conventions ed utilizzeremo un tool open source, di- 
sponibile anche come plugin per Eclipse, in grado di 
analizzare il codice di un nostro progetto e di dirci do- 
ve questo non è conforme al nostro pacchetto persona- 
lizzato di regole. 

ELEMENTI DI SEPARAZIONE 

Uno dei requisiti richiesti al codice di qualità è la sua 
leggibilità anche, e soprattutto, per chi non lo ha scrit- 
to e non lo conosce. La sua impaginazione è quindi im- 
portante e di conseguenza diventa essenziale sapere 
come gestire gli elementi di separazione del codice, 
cioè spazi bianchi e linee vuote. 

Le linee vuote 

In generale aumentano la leggibilità facendo risaltare 
sezioni di codice che sono tra loro logicamente correla- 
te. Una doppia linea bianca dovrebbe essere sempre 
usata per separare sezioni omogenee di codice in un fi- 
le sorgente e fra le definizioni di classe e di interfaccia. 
In altre situazioni nelle quali sia necessario separare 
porzioni di codice tra loro diverse può essere sufficien- 
te un'unica linea vuota, come nelle seguenti: 



• Fra metodi della stessa classe 

• Fra le dichiarazione delle variabili locali in un me- 
todo e la sua prima istruzione 

• Prima di un commento di blocco o a singola linea 

• Fra sezioni logiche air interno di un metodo per mi- 
gliorarne la leggibilità 

Gli spazi bianchi 

Dopo rimpaginazione verticale anche quella orizzon- 
tale vuole la sua parte, ecco quindi la necessità di uti- 
lizzare gli spazi bianchi in molte situazioni, vediamole: 

• Quando c'è una parola chiave seguita da una pa- 
rentesi: 

while (true) { 
■ ■■ > 

• Dopo le virgole che separano gli argomenti di un 
metodo: 

Database dbProp = (Database)rwp.getPropObj( 

"Database", nome); 

• Tutti gli operatori binari eccetto il punto dovrebbe- 
ro essere separati dai loro operandi tramite spazi. 
Viceversa gli spazi bianchi non dovrebbero mai se- 
parare gli operatori unari come l'operatore meno, 
l'incremento ("'++"), e il decremento ("-") dai loro 
operandi. 

a += e + d; 

a = (a + b) / (e * d); 

while (d++ = s++) { 

n++;> 
printSize("size is " + foo + "\n"); 

• Le espressioni in un'istruzione for dovrebbero esse- 
re separate da spazi bianchi: 



Checkstyle 



I ~gj Checkstyle è uno 
|vj/| strumento open 
source di valutazione 
automatica della con- 
formità del codice Java 
che applica un set con- 
figurabile e personaliz- 
zabile di regole. 
L'utilizzo tradizionale 
di Checkstyle prevede 
un insieme di tool linea 
di comando che per- 
mettono di selezionare 
quale codice valutare 
ed attraverso quale 
configurazione di rego- 
le. Le regole, e le loro 
severity, sono configu- 
rate su file XML. 
Per abbassare il tempo 
di apprendimento e per 
renderlo uno strumen- 
to integrabile, esiste 
una versione di Check- 
style distribuita sotto 
forma di plugin per 
Eclipse. 
\soft\checkstyle-3.1.zip 
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Data Hiding 



a: 



I II Data Hiding è 
| uno dei fonda- 
menti del paradigma 
Object Oriented e con- 
siste nel non avere, al- 
l'interno di una classe, 
oggetti e variabili pub- 
blici che possano esse- 
re letti e scritti diretta- 
mente senza l'utilizzo 
di appositi metodi di 
lettura e scrittura. 



Convenzioni 

Le Code Conven- 
tions for the Java 



3 



Programming Langua- 
ge sono delle linee gui- 
da sintattiche promos- 
se direttamente da Sun 
Microsystem e che 
hanno l'obiettivo di in- 
dicare come deve esse- 
re scritto il codice Java 
per poter essere imme- 
diatamente comprensi- 
bile anche da chi non lo 
ha direttamente scrit- 
to. 



for (exprl; expr2; expr3) 

• I cast, per la loro importanza, dovrebbero essere se- 
guiti da uno spazio bianco: 

myMethod((byte) aNum, (Object) x); 
myMethod((int) (cp + 5), ((int) (i + 3)) + 1); 

Naming 

Le convenzioni di naming permettono di avere softwa- 
re più comprensibile e leggibile anche per chi non lo ha 
scritto. In generale esiste una regola per ogni tipo di 
identificatore, vediamo le principali: 

• I package: il prefisso univoco deve essere scritto in 
minuscolo e rappresentare, per quanto possibile, 
un suffisso di dominio di massimo livello (com, net, 
org). 

• Le classi: il nome di una classe e delle interfacce 
sono sostantivi con Y iniziale (di ogni parola inter- 
na costituente il nome completo) maiuscola. 

• I metodi: il nome di un metodo è un predicato con 
l'iniziale minuscola, ma con le iniziali di eventuali 
parole interne scritte invece in carattere maiuscolo. 

• Gli oggetti: il nome di un'istanza di classe è un so- 
stantivo che lo descrive funzionalmente, ha l'ini- 
ziale minuscola, ma le iniziali di eventuali parole 
interne sono scritte in carattere maiuscolo. E' per- 
messo l'utilizzo di nomi dotati di una singola lette- 
ra per variabili particolari come gli indici dei cicli. 

• Le costanti: sono scritte in caratteri maiuscoli e la 
separazione tra una parola e l'altra è data da un ca- 
rattere underscore. 

CONSUETUDINI 

DI SCRITTURA DEL CODICE 

Quando si scrive software è bene adattarsi alle regole 
di stesura del codice proprie del gruppo di lavoro con 
il quale si collabora. In ogni caso esistono alcune con- 
venzioni e consuetudini che dovrebbero sempre esse- 
re seguite per ottenere software di qualità sintattica 
migliore. 

Metodi di classi statiche 

In presenza di classi statiche è buona norma riferirsi ai 
loro metodi utilizzando la sintassi AClass.classMe- 
thod(); e non invece la sintassi propria dei metodi tra- 
dizionali anObject.classMethodQ; 

Assegnamento di valori alle variabili 

La prima cosa da evitare è l'utilizzo di una sola 
istruzione per assegnare lo stesso valore a variabili 
differenti attraverso la sintassi fooBar.fChar = 
barFoo.lchar = 'e'; che è davvero difficile da leggere. 
Altra cosa da non fare è la ricerca dell'ottimizza- 
zione stretta nel codice, magari attraverso l'utilizzo 
di assegnamenti uno dentro l'altro, come in questo 
caso: 



d = (a = b + e) + r; 

Lo stesso codice può (e deve) essere scritto con una sin- 
tassi più comprensibile come questa: 

a = b + e; 
d = a + r; 

Parentesi 

La lettura del codice deve molto, come si diceva, al 
raggruppamento di oggetti omogenei ed alla separa- 
zione di questi gruppi da altri che tra loro non lo sia- 
no. Per questi motivi le parentesi possono essere usate 
per raggruppare tra loro espressioni che debbano in 
qualche modo essere separate da altre, non solo per la 
corretta esecuzione del codice, ma anche per motivi di 
leggibilità. Il codice della riga seguente, per esempio: 

if (a == b &&c == d) 

è da evitare perché potrebbe causare confusione in let- 
tura da parte di chi non abbia estremamente chiare le 
problematiche di precedenza tra gli operatori. In ogni 
caso la stessa riga di codice può essere scritta in questo 
modo: 

if ((a == b) &&(c == d)) 

risultando più leggibile e comprensibile. 

I VALORI DI RITORNO 

Il codice dovrebbe essere scritto il più semplicemente 
possibile, nel caso del valore ritornato da un metodo è 
possibile scrivere una frammento come questo: 

if (booleanExpression) { 
return true; } else { 
return false; } 

E' chiaro però che l'obiettivo è restituire al chiamante lo 
stesso valore dell'espressione che viene valutata, per- 
tanto questo codice andrebbe riscritto in questo modo: 

return booleanExpression; 

Allo stesso modo è importante conoscere a fondo tutti 
i costrutti del linguaggio, anche quelli che si utilizzano 
di meno, in quanto spesso ci offrono grandi potenzia- 
lità. 

Prendiamo in esame, per esempio, questo frammento 
di codice: 

if (condition) { 
return x; } 
return y; 

Dovremmo sapere che lo stesso risultato si può ottene- 
re attraverso questo operatore ternario: 
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return (condition ? x : y); 

Proprio con l'utilizzo di questo operatore è necessario 
porre la massima attenzione alla condizione che, nel 
caso in cui sia una condizione composta, deve essere 
racchiusa tra parentesi in questo modo: 

return ((x > y) ? x : y); 



IL CODICE PERFETTO? 

Esiste un frammento di codice che soddisfi tutte le nor- 
me indicate nelle Code Conventions fot the Java Program- 
ming Language? La risposta di chi sviluppa codice Java 
può essere di due tipi: 

• Tutto il mio codice è conforme alle Code Conven- 
tions! 

• Nel mio codice conta il risultato e non la forma! 

Il buon senso, come sempre, deve avere la meglio sugli 
estremismi da una parte e dall'altra, quindi è impor- 
tante che il software soddisfi i requisiti per cui è scrit- 
to, ma è altrettanto importante che sia scritto in manie- 
ra comprensibile per evitare che sia troppo oneroso un 
intervento di manutenzione. In ogni caso c'è da dire 
che il codice perfetto, almeno dal punto di vista forma- 
le, esiste ed è quello indicato come esempio dalle stes- 
se Code Conventions, vediamolo e cerchiamo di capire 
quanto assomigli al nostro. 



/* 
* @(#)Blah.java 



1.82 99/03/18 



* Copyright (e) 1994-1999 Sun Microsystems, Inc. 

* 901 San Antonio Road, Palo Alto, California, 94303, 

U.S.A. 

* Ali rights reserved. 

* 

* This software is the confidential and proprietary 

information of Sun 

* Microsystems, Inc. ("Confidential Information"). 

You shall not 

* disclose such Confidential Information and shall use 

it only in 

* accordance with the terms of the license agreement 

you entered into 

* with Sun. 
J7 

package java.blah; 

import java.blah.blahdy.BlahBlah; 

/** 

* Class description goes here. 

* 

* (cpversion 1.82 18 Mar 1999 

* @author Firstname Lastname 
J7 

public class Blah extends SomeClass { 

/* A class implementation comment can go here. */ 



/** classVarl documentation comment */ 
public static int classVarl; 

/** 

* classVar2 documentation comment that happens to be 

* more than one line long 

*/ 

private static Object classVar2; 
/** instanceVarl documentation comment */ 
public Object instanceVarl; 
/** instanceVar2 documentation comment */ 
protected int instanceVar2; 
/** instanceVar3 documentation comment */ 
private Object[] instanceVar3; 
/** 

* ...constructor Blah documentation comment... 
*/ 

public BlahQ { 

// ...implementation goes here... } 

/** 

* ...method doSomething documentation comment... 

*/ 
public void doSomething() { 

// ...implementation goes here... } 

/** 

* ...method doSomethingElse documentation comment... 

* @param someParam description 

*/ 

public void doSomethingElse(Object someParam) { 
// ...implementation goes here... } } 



STRUMENTI DI VALUTAZIONE 

Una delle cose da evitare in generale, quando si scrive 
un frammento di codice, è l'attenzione maniacale alla 
forma, proprio perché, come è stato detto in preceden- 
za, il buon senso deve avere la meglio comunque sugli 
estremismi di parte. Poiché chi scrive il codice si con- 
centra soprattutto suirimplementazione dell'algorit- 
mo, è bene produrre, tanto per iniziare, uno scheletro 
funzionante del pezzo di codice in stesura ed in un se- 
condo momento si potrà rivedere la forma analizzan- 
do nuovamente il codice e conformandolo alle specifi- 
che di qualità formale esistenti, qualunque esse siano. 
Questa seconda parte, però, spesso viene trascurata 
perché si considera un'attività secondaria che in ogni 
caso non pregiudica il funzionamento del codice e so- 
prattutto davvero noiosa e quasi impossibile da com- 
piere senza errori. Perché allora non appoggiarci a 
strumenti di valutazione automatica della conformità 
del nostro codice con un set di regole configurabili, ma- 
gari open source? Di strumenti di questo genere ne esi- 
stono molti, ma si tratta spesso di oggetti commerciali 
molto sofisticati e costosi, ragion per cui spesso non si 
ha la possibilità di utilizzarli e di apprezzarne i van- 
taggi- 

In questo panorama un po' desolante spicca però la 
presenza di un tool open source che soddisfa ampia- 
mente i nostri requisiti: si tratta del progetto Checkstyle, 
giunto alla versione 3.1 e disponibile gratuitamente su 
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Vantaggi 



I ^a I L'utilizzo di con- 
\--y\ venzioni, in gene- 
rale, è una buona abi- 
tudine che permette a 
chi lavora in gruppo di 
abbassare i problemi di 
comprensione del codi- 
ce scritto da altri. Altro 
vantaggio di un ap- 
proccio rigido alle con- 
venzioni è la possibilità 
di manutenere con più 
facilità il codice scritto 
anche a distanza di 
molto tempo. Tutto 
questo si traduce in 
una implicita qualità 
sintattica del codice 
prodotto. 
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La qualità 
del codice 

L'analisi qualitati- 
va di un frammen- 



Ó 



to di codice si divide in 
due grandi rami: Tana- 
lisi della qualità sintat- 
tica e l'analisi della 
qualità semantica. 
La qualità sintattica, e 
quindi la conformità 
del codice con certe re- 
gole e convenzioni, può 
essere effettuata an- 
che con strumenti au- 
tomatici di validazione. 
La qualità semantica 
invece, cioè l'utilizzo 
intelligente dei co- 
strutti di programma- 
zione in funzione del- 
l'algoritmo da imple- 
mentare, non è sempre 
verificabile in maniera 
automatica se non per 
approssimazioni, per- 
tanto è bene compren- 
derne le problematiche 
per produrre codice ro- 
busto e qualitativa- 
mente efficace. 



sourceforge all'indirizzo http://checkstyle.sourceforge 
.net/. 



CHECKSTYLE 

Una volta scaricato il software e scompattato l'archivio 
ci troveremo di fronte all'alberatura visibile Fig. 1. 



■ & I ■» "S X « E; 



- _J che ckstyle-3.1 

- _J contrib 

! B-Q examples 



- _lapi 
BÌ com 
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É-Q tools 



Iciocs 
_'. 

_|.t. 
^ctectayle-3 
Kjchetkstyle-a 
-!■:■ **■* 



- _l checks 
_l class-i 
- _J indent 



16 (Spazio disponibile 



Fig. 1: Alberatura completa che si ottiene dopo 
avere decompresso l'archivio di distribuzione di 
CheckStyle. 



Checkstyle è principalmente un tool a linea di comando 
che esegue un controllo di conformità su un file Java (o 
un gruppo di file fino ad un intero progetto grazie an- 
che alla completa integrazione con ANT). Le regole da 
verificare ed il grado di severity di una eventuale non 
conformità sono configurabili e memorizzabili in file 
XML per i quali è presente un'apposita grammatica. 
Insieme al pacchetto sono disponibili già, come esem- 
pio, due file di configurazione pronti per l'uso: uno 
contenente un pacchetto di regole personalizzato di 
Checkstyle ed un altro contenente una completa rimap- 
patura delle Code Conventions di cui abbiamo parlato in 
precedenza. Proviamo ad analizzare qualche pezzo di 
codice Java utilizzando il tool a linea di comando. 
Per prima cosa è necessario includere nel classpath tut- 
ti gli archivi JAR presenti nel pacchetto di Checkstyle, 
quindi siamo pronti ad analizzare un file Java. Pren- 
diamo come cavia il sorgente della classe ListTag che 
implementa una delle tag library dell'applicazione 
multicanale presentata nel numero di ioProgrammo 
del mese scorso. Vogliamo verificare il file secondo le 
Code Conventions, quindi utilizzeremo il file sun_checks 
.xml messo a disposizione da Checkstyle. Il comando 
che dovremo eseguire per eseguire questo controllo è il 
seguente: 

java com. puppycrawl. tools. checkstyle. Main \ 

-e percorso_di_checkstyle/docs/sun_checks.xml \ 

percorso_del_sorgente\l_istTag.java 

ed il risultato di questo test è visibile in Fig. 2. Si tratta, 
come si può notare, di una lunga sequenza di warning, 
a testimonianza del fatto che il codice, seppur funzio- 
nante, non è dotato di grande qualità sintattica. Certo, 
analizzare questa sequenza di warning e tentare di 
porre rimedio manualmente ad ogni singola segnala- 
zione potrebbe essere un lavoro lungo e noioso, pro- 



prio quello che si deve evitare se vogliamo essere in- 
vogliati a rispettare le regole sintattiche. Ecco quindi 
che ci viene incontro un altro strumento, che fa da pon- 
te tra Checkstyle ed Eclipse, (ambiente di sviluppo open 
source che potete trovare nel CD allegato a ioProgram- 
mo n.71, in edicola il mese scorso). 




Fig. 2: La lunga sequenza di warning ottenuta 
dall'esecuzione di un test con CheckStyle su un file 
sorgente. 



CHECKSTYLE COME PLUGIN 
PER ECLIPSE 

Lo strumento di cui parliamo è un plugin per Eclipse 
con lo stesso motore di Checkstyle, progetto open sour- 
ce anch'esso ospitato su sourceforge scaricabile diretta- 
mente dal sito http://eclipse-cs.sourceforge.net/. 




E C2 coni. atlass^. 1 . tools. eclipse. checl st\le_3. 1 

à-Sig 

; -Q images 
_J license 



Jdoc 

. I license 

h style-all-3.1.jar 
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|£) README.html 

f fl'.ui. mi 



Oggetti: 7 (Spazio disponibile: 34,7 MB) 



JUL 



J 



11,13 MB |g Risorse del computer 



Fig. 3: Alberatura completa che si ottiene dopo 
aver decompresso l'archivio di distribuzione del 
plugin per Eclipse. 



Una volta scaricato il software e scompattato l'archivio 
ci troveremo di fronte all'alberatura visibile in Fig. 3, 
per l'installazione non dovremo fare altro che copiare 
la cartella com. atlassw. tools. eclipse. checkstyle _3. ,1.0 all'in- 
terno della directory plugins di Ecplise. La configura- 
zione del plugin è un'operazione molto importante, in 
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Fig. 4: Interfaccia di definizione delle 
configurazioni del plugin in Eclipse. 
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Fig. 5: Ogni singola regola di conformità è 
configurabile nei minimi dettagli. 



quanto ci permette di selezionare quali regole applica- 
re ed in quali contesti. Questa viene fatta dalla sezione 
window/preferences attraverso l'interfaccia di Fig. 4, nel- 
la quale è possibile definire diverse configurazioni, cia- 
scuna delle quali contiene tutte e sole le regole che sa- 
ranno applicate e per ogni regola è possibile determi- 
nare se la non conformità con questa sia da rilevare co- 
me informazione, warning o errore. In Fig. 5 è visibile 
la configurazione puntuale di una singola regola. 
Agendo in questo modo è possibile ottenere set di re- 
gole personalizzate a livello di azienda o di singolo 
progetto per eliminare regole che non si ritengono im- 
portanti, oppure obbligare gli sviluppatori a rispettar- 
ne alcune che al contrario si reputano fondamentali per 
la qualità della produzione. Una volta configurato il set 
di regole da applicare, possiamo selezionarlo attraver- 
so l'interfaccia di Fig. 6. A questo punto, confermando 




Fig. 6: Selezione del set di regole da applicare per 
eseguire la verifica di conformità. 

le selezioni, avviene l'esecuzione del test che utilizza il 
motore di Checkstyle, attraverso l'applicazione del set 
di regole che abbiamo confezionato su misura per il no- 
stro progetto. Il risultato dell'esecuzione del test, visi- 
bile in Fig. 7, è l'inserimento nella list dei task da ese- 
guire di Eclipse, di un task per ogni violazione alle re- 
gole che il motore di Checkstyle ha rilevato. Questo 
comportamento fa si che, selezionando la singola se- 
gnalazione sia possibile posizionarsi direttamente con 
l'editor nel file che corretto e nella posizione esatta do- 
ve è stata rilevata la non conformità. A questo punto la 



gestione della qualità sintattica diventa un processo di 
routine che coinvolge tutti gli sviluppatori, ciascuno 
per le proprie porzioni di codice e non è più un'attività 
separata che porta via tempo. In questo modo si otti- 
mizzano gli sforzi di correzione del codice, consenten- 
do a chi sviluppa di correggere eventuali errori forma- 
li allo stesso modo e con gli stessi strumenti utilizzati 
per correggere errori sostanziali che non permettereb- 
bero la compilazione. 




Fig. 7: Al termine dell'esecuzione del test ogni 
warning viene inserito nella lista dei task da 
eseguire di Eclipse. 



CONCLUSIONI 

Proviamo a rivedere gli assiomi generali da cui erava- 
mo partiti: 

• il software deve eseguire il compito per il quale è 
stato progettato e scritto 

• il software deve essere scritto bene e deve essere 
manutenibile 

La validità di entrambi, se il nostro obiettivo è scrivere 
sofware di qualità, non può essere in discussione, ma 
mentre per il primo ci deve essere sempre grande at- 
tenzione (pena il mancato raggiungimento degli obiet- 
tivi di progetto e spesso la perdita di qualche cliente), 
per il secondo si può essere, in generale, meno intran- 
sigenti in quanto un progetto software può funzionare 
alla perfezione anche se il codice non è scritto in ma- 
niera eccellente. In ogni caso, per motivi di manuteni- 
bilità, documentazione e comprensione dei progetti 
software, come sappiamo, è bene che vengano seguite 
in maniera precisa le procedure di qualità sintattica e di 
documentazione che permettano di soddisfare anche il 
secondo assioma. In questo articolo, oltre a descrivere 
la seconda parte delle regole cui dovrebbe attenersi 
chiunque sviluppa codice Java, è stata descritta anche 
una metodologia pratica di approccio al problema ed 
abbiamo visto come con gli strumenti giusti, e magari 
a costo zero, sia possibile inglobare la correzione di er- 
rori formali del codice all'interno della revisione del co- 
dice stesso, aumentando al contempo la produttività e 
la qualità della produzione. 

Massimo Canducci 
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Eclipse 

I /-si Eclipse è un am- 
\^J\ biente di sviluppo 
Java basato su un pro- 
getto sviluppato ini- 
zialmente da IBM e do- 
nato successivamente 
alla comunità open 
source. 

II senso di Eclipse, dal- 
la nascita del progetto, 
è quello di fornire agli 
sviluppatori degli stru- 
menti di sviluppo sem- 
pre più sofisticati e po- 
tenti grazie ad un uni- 
co framework che inte- 
gri potenzialmente tut- 
ti i linguaggi, gli Ide, i 
tool di modeling e gli 
strumenti di collabora- 
zione esistenti. 

Il framework è basato 
su un sistema di API 
pubbliche e di plug-in 
le cui specifiche di svi- 
luppo sono di pubblico 
dominio. Questo per- 
mette a chiunque di 
sviluppare i propri plu- 
gin e renderli disponi- 
bili alla comunità open 
source oppure a paga- 
mento. 

L'ambiente completo è 
stato allegato al nume- 
ro 71 di ioProgrammo 
ed è disponibile all'in- 
dirizzo www.eclipse.org . 
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Java e 
UDDI 



^ Web Services e Java: tecniche di interrogazione. 

Accedere con Java 



ai registri U 



ii 



i 



Nei servizi Web, gioca un ruolo determinante UDDI. 
Acronimo di Universal Directory & Description Interface, 
può essere identificato da tre componenti diverse: 
un registro mondiale di servizi web, un insieme di 
specifiche ed un consorzio che li gestisce entrambi. 



BulkResponse 



^a I L'interfaccia Bulk- 
^/| Response permet- 
te di contenere, all'inter- 
no di un unico oggetto, 
un vasto insieme di og- 
getti eterogenei di rispo- 
sta, di eccezioni e codici 
di stato. Come vedremo 
in seguito, in caso di ri- 
sposta corretta, sarà 
possibile ottenere dalla 
BulkResponse una colle- 
zione contenente i dati 
ritornati dalla ricerca. 



Nel panorama dei Web Services, Java rap- 
presenta una componente fondamentale. 
Da un recente sondaggio è emerso come 
una grossa percentuale di sviluppatori utilizzi 
questo linguaggio e questa piattaforma per co- 
struire la propria infrastruttura di servizi Web. Pa- 
radossalmente, gli sviluppatori che utilizzano Ja- 
va sono di più rispetto alla loro controparte .NET, 
forse per via della non ancora consolidata pene- 
trazione di mercato di quest'ultima. 



LA NATURA DI UDDI 

Il consorzio UDDI è un'insieme di aziende che si 
occupano di studiare le specifiche e di mantenere 
l'implementazione del registro. Tra i sostenitori 
del consorzio troviamo colossi come IBM, Micro- 
soft, Ariba ed anche SUN Microsystems. Attual- 
mente le specifiche hanno raggiunto la versione 
3.0 e, come previsto dalla road-map del progetto, 
sono state cedute ad un ente per la standardizza- 
zione, in particolare ad OASIS e UN-CEFACT, un 
ente delle nazioni unite che hanno già in gestione 
gli standard ebXML. UDDI dovrebbe essere l'ele- 
mento fondamentale che, insieme a SOAP (proto- 
collo di comunicazione basato su XML) ed ai pro- 
tocolli Internet, completa la visione dei Web Ser- 
vices. Questa prevede che le società espongano i 
propri componenti business sul Web, per essere 
rintracciabili da chiunque e per questo è indispen- 
sabile un meccanismo che consenta ai fornitori ed 
ai clienti di incontrarsi. 

Questo punto di incontro dovrebbe essere costi- 
tuito dai registri, una sorta di pagine gialle mon- 
diali. In particolare, le informazioni gestite da 
UDDI sono: 



• pagine bianche - informazioni anagrafiche 
delle aziende quali numeri telefonici, indirizzi 
e riferimenti Web. Sono dati che consentono 
un contatto a livello umano prima che tecnico; 

• pagine gialle - catalogano i servizi e le azien- 
de. Per via della natura mondiale del registro, 
le categorie hanno rilevanza globale e possono 
essere le più disparate. Ad esempio è possibile 
categorizzare un'azienda in base all'area geo- 
grafica in cui opera (Europa, Italia, Milano), 
oppure in base al suo segmento funzionale 
(Business, Finanza, Prestiti, Mutui); 

• pagine verdi - descrivono le informazioni tec- 
niche dei servizi, per quelli integrabili diretta- 
mente a livello informatico. Un esempio sono 
gli URL dei servizi, o dei puntatori a file 
WSDL. 

Le principali funzionalità offerte dai registri UD- 
DI coinvolgono dunque la pubblicazione e la ri- 
cerca delle informazioni sopra descritte: 

• pubblicazione - le funzioni di pubblicazione 
sul registro consentono di inviare le informa- 
zioni relative alle società ed ai servizi al regi- 
stro stesso; 

• individuazione - una volta pubblicate le infor- 
mazioni, queste possono essere individuate da 
eventuali acquirenti tramite il processo di in- 
dividuazione. 

Si noti che le operazioni che coinvolgono il regi- 
stro, possono essere svolte da strumenti di terze 
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parti. Queste non rientrano infatti nel classico 
workflow relativo ai servizi Web caratterizzato 
primariamente dalla presenza di SOAR Tipica- 
mente, il protocollo di trasporto (SOAP), i file di 
definizione (come WSDL) ed i registri agiscono in 
momenti differenti tra loro. Infatti, il protocollo di 
trasporto interviene quando già i programmi 
client e server sono stati costruiti mentre la docu- 
mentazione WSDL interviene in fase di creazione 
dei client e server. Il registro interviene a monte, 
per identificare i WSDL (o informazioni equiva- 
lenti) dei servizi da interfacciare. Ma come fun- 
ziona il registro globale? La cosa più interessante 
è che non si basa su un singolo server ma utilizza 
un approccio distribuito simile al DNS. Le infor- 
mazioni vengono sempre comunicate ad uno spe- 
cifico nodo, ma questo poi si occuperà di propa- 
garle a tutti gli altri nodi UDDI della rete. Così, ad 
esempio, se comunichiamo con un nodo ospitato 
da IBM, le informazioni arriveranno anche agli al- 
tri nodi, ad esempio quelli ospitati da Microsoft, o 
da SUN. In questo modo viene garantita una cer- 
ta affidabilità tramite la ridondanza dei sistemi e 
delle informazioni. Nonostante questo, il nodo a 
cui si comunicano le informazioni riveste ancora 
un ruolo fondamentale poiché alcune funzioni 
possono successive essere eseguite solo su di esso. 




Web Services and UDDI 

* and uddi Universal Description. Discovery, and Integration 




Fig. 1: Esistono diversi strumenti per accedere ad 
UDDI, il più immediato da vedere è l'interfaccia 
Web che propongono i costruttori, ad esempio IBM. 



Quando si comunicano informazioni ad un nodo, 
questo diviene il proprietario. Funzioni successive, 
ad esempio l'eliminazione dei dati, possono esse- 
re eseguite solo sul nodo proprietario. 



INTERFACCIARE UDDI 

Le API di UDDI sono particolari: se si osservano 
le specifiche (vedi bibliografia) si noterà che non 
sono definite come specifiche di un particolare 
linguaggio, ma sono espresse come flussi SOAP. 
Le primitive di UDDI sono infatti esse stesse ser- 
vizi Web. In questo modo non é stato necessario 
definire un insieme di API per ciascuna piattafor- 
ma supportata: la piattaforma nativa di UDDI é 
quella dei servizi Web. Nel mondo Java, per ope- 



rare con UDDI esistono dunque tre differenti stra- 
tegie: 

• SOAP. Si possono utilizzare SAAJ e JAXM per 
dialogare direttamente in SOAP con il registro. 
È inoltre possibile pensare di recuperare i 
WSDL dei servizi UDDI e di utilizzare JAX- 
RPC per costruire un modello Java delle chia- 
mate UDDI. 

• API proprietarie. Fornitori di software di base 
per i servizi Web offrono prodotti di integra- 
zione che oltre al supporto a SOAP e WSDL 
forniscono API molto semplici per l'accesso ad 
UDDI. 

• JAXR (Java API for XML Registries). E' lo 

standard della piattaforma Java per l'accesso 
ai registri di servizi Web. L'implementazione 
di riferimento é contenuta nel JWSDP (Java 
Web Services Developer Pack), disponibile per il 
download al sito ufficiale di SUN. 

Operare direttamente con SOAP può non essere 
facile: è necessario trattare dati in XML e gestire le 
comunicazioni più o meno a basso livello. La scel- 
ta di operare con API proprietarie o standard è 
sempre delicata: se da una parte le API proprieta- 
rie possono essere più semplici, dall'altra costrin- 
gono all'utilizzo del software di un particolare 
produttore. 

Ad ogni modo, le API standard garantiscono una 
certa scelta per i fornitori di software anche se 
possono risultare più complesse. 



JAXR 

Queste API di SUN risultano abbastanza com- 
plesse, non solo perché non sono legate ad uno 
specifico prodotto (in questo caso non avrebbe fat- 
to molta differenza) ma più per il fatto che godo- 
no di un'architettura multi-registro. Le API JAXR 
non sono infatti vincolate solo all'utilizzo di 
UDDI ma possono interagire anche con altri tipi 
di registro come ebXML-R. Questo è l'altro stan- 
dard mondiale per la creazione dei registri Web, 
meno famoso in quanto per certi versi meno "con- 
siderato" di UDDI. Con il fatto che le specifiche 
UDDI sono ora in gestione dallo stesso consorzio 
che ha in mano ebXML-R, è possibile pensare ad 
una convergenza delle specifiche e quindi ad una 
minore importanza dell'architettura così aperta di 
JAXR. La cosa da segnalare è che il modello infor- 
mativo (le classi che definiscono le entità presenti 
nel registro) di JAXR é in realtà mutuato da 
ebXML. Inoltre, le API JAXR dispongono, oltre che 
delle chiamate generalizzate per operare con la 
pubblicazione e la ricerca delle informazioni su 
generici registri, anche di API specifiche per UD- 
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I UDDI dovrebbe es- 
| sere l'elemento 
fondamentale che, insie- 
me al protocollo di co- 
municazione basato su 
XML ed ai protocolli In- 
ternet, completa la vi- 
sione dei Web Services. 
Questa prevede che le 
società espongano i pro- 
pri componenti di busi- 
ness sul Web per essere 
rintracciabili da chiun- 
que e per questo è indi- 
spensabile un meccani- 
smo che consenta ai for- 
nitori ed i clienti di in- 
contrarsi reciprocamen- 
te. 
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I ^a I Quando si comu- 
\^J I nicano informa- 
zioni ad un nodo, que- 
sto diviene il proprieta- 
rio. Funzioni successi- 
ve, ad esempio l'elimi- 
nazione dei dati, pos- 
sono essere eseguiti 
solo sul nodo proprie- 
tario. 



DI, che hanno l'obiettivo di offrire API familiari e 
semplici da utilizzare allo sviluppatore abituato a 
questo registro. Senza addentrarci nei complessi 
meandri di JAXR, verrà analizzato un programma 
di esempio per l'accesso al registro UDDI che ese- 
gue la ricerca di una azienda. Il programma é pre- 
sente nel JWSDP nel file BusinessQueryTest.java. 



CONNESSIONI E MANAGER 

Come molte altre API della piattaforma Java, 
JAXR fa largo uso di design pattern, in particolare 
del pattern futures e di factory. Quest'ultimo viene 
utilizzato per gestire le connessioni al registro: 
tutte le operazioni possibili in JAXR sono effettua- 
bili agendo su oggetti in qualche modo forniti da 
una connessione al registro. Le connessioni vengono 
fornite al programma tramite la classe Connection- 
Factory. Questa dispone del metodo newInstanceO 
che resituisce una factory che può essere utilizzata 
per stabilire le connessioni. Sono molti i parametri 
che possono intervenire in fase di connessione ad 
un registro ed alcuni potrebbero essere specifici in 
funzione di un dato registro. Questi parametri 
vanno passati alla factory tramite il metodo setPro- 
pertiesO sotto forma di oggetto Properties. I basila- 



• javax.xml.registry.queryManagerURL - Indi- 
ca l'URL di accesso al registro per le operazio- 
ni di ricerca. 

• javax.xml.registry.lifeCycleManagerURL - 

Indica l'URL di accesso al registro per le ope- 
razioni di pubblicazione. 

• javax.xml.registry.factoryClass - Indica la 
classe JAXR che implementa la factory. Ad 
esempio: 

com.sun .xml.registry.uddi.ConnectionFactorylmpI 

• com.sun.xml.registry.http.proxyHost - Indica 
il nome del computer che funge da proxy per 
l'accesso ad Internet. 

• com.sun.xml.registry.http.proxyPort - Indica 
la porta del computer che funge da proxy per 
l'accesso ad Internet. 

Una volta ottenuta la connessione é possibile 
passare alla richiesta della connessione, trami- 
te il metodo createConnectionO: 

Connection conn = factory.createConnection(); 

A questo punto è possibile ottenere l'oggetto che 
si occupa di eseguire la query in modalità sempli- 
ficata: il BusinessQuery Manager. Per prima cosa é 
necessario passare dall'oggetto che rappresenta il 



servizio del registro per poi passare al vero e pro- 
prio BusinessQueryManager: 

RegistryService rs = conn.getRegistryService(); 
BusinessQueryManager bqm = 

rs.getBusinessQueryManager(); 

Tramite l'oggetto BusinessQueryManager é ora pos- 
sibile cercare le aziende che rispondono a deter- 
minati criteri, tramite il metodo findOrganiza- 
tions(). 



CERCARE CON JAXR 

A questo punto è bene introdurre alcuni concetti 
peculiari di JAXR. Per prima cosa, è interessante 
notare come è conformato il codice che esegue la 
ricerca: essendo i registri Web strutturati per con- 
tenere una miriade di informazioni, risulta di fon- 
damentale importanza la possibilità di applicare 
ricerche "complesse". JAXR viene in contro a que- 
sta necessità consentendo di specificare una serie 
di parametri di selezione. Ad esempio, per la ri- 
cerca di aziende é possibile specificare: 

• findQualifiers - Una serie di qualificatori de- 
finiti in accordo all'interfaccia FindQualifier che 
permettono di definire i criteri di base utiliz- 
zati per l'ordinamento, il confronto ed altri cri- 
teri similari per le stringhe. 

• namePatterns - Contiene un elenco di pattern 
tipo SQL con i nomi delle aziende da cercare. 
Ad esempio "SU% " cerca tutte le aziende che 
cominciano con "SU". Se vengono specificati 
più pattern, la ricerca é cumulativa, a meno 
che i findQualifiers specifichino un comporta- 
mento differente. 

• classifications - Individuano le classificazioni 
a cui i nominativi devono appartenere. Ad 
esempio, se il nome di una società risponde ai 
precedenti parametri ma é catalogata come 
"Francese" e le classificazioni richieste specifi- 
cano solo "Italiana " , questa non verrà ritornata 
nella ricerca. 

• specifications - Individua le specifiche tecni- 
che dei servizi Web; il funzionamento é analo- 
go alle classificazioni: vengono ritornate solo 
le aziende in grado di fornire determinati ser- 
vizi identificati dalle specifications. 

• externalldentifiers - Opera in modo similare 
alle precedenti ma tratta di identificativi ester- 
ni, come le classificazioni DUNS. 

• externalLinks - Restringe la ricerca alle entità 
che supportano i link esterni specificati. I link 



126 ►►► S e t t 



http ://www. ioprogrammo.net 



esterni puntano a dettagli tecnici necessari per 
invocare il servizio. 

Se non si desidera utilizzare uno o più parametri 
di ricerca, è sufficiente passare nuli come parame- 
tro. La chiamata findOrganizationsO ritorna come 
risposta un oggetto BulkResponse. Questo ci con- 
sente di affrontare due concetti di JAXR: per pri- 
ma cosa, si può notare che tra le strutture dati e le 
API esiste un accoppiamento lasco. Questo è do- 
vuto al fatto che i registri sono basati su servizi 
SOAP. Un servizio SOAP può ritornare strutture 
dati eterogenee, in funzione della tipologia di ri- 
sposta da dare: un approccio sicuramente diffe- 
rente rispetto al linguaggi strong-typed come Java 
che richiedono, ad esempio, l'indicazione specifi- 
ca di un tipo per il valore di ritorno di un metodo. 
L'interfaccia BulkResponse permette di contenere, 
all'interno di un unico oggetto, un vasto insieme 
di oggetti eterogenei di risposta, di eccezioni e co- 
dici di stato. Come vedremo in seguito, in caso di 
risposta corretta, sarà possibile ottenere dalla 
BulkResponse una collezione contenente i dati ri- 
tornati dalla ricerca. Un'altra particolarità si na- 
sconde dietro gli oggetti ritornati in BulkResponse 
(e che fanno parte del modello informativo di 
JAXR): questi adottano il già citato pattern futures, 
detto anche lazy loading. Questo particolare pat- 
tern, a cui ci si riferisce anche come loading on-de- 
mand, prevede che gli oggetti del modello infor- 
mativo vengano subito ritornati al client, senza 
che il caricamento di tutte le informazioni sia 
completato. Solo al momento dell'invocazione di 
un particolare metodo getter, l'informazione ri- 
chiesta verrà recuperata (eventualmente insieme 
ad altri dati) allo scopo di ottimizzare le comuni- 
cazioni di rete. Questo approccio ha una serie di 
conseguenze: quella più immediata è la maggiore 
responsività di JAXR che, dovendo estrarre un nu- 
mero limitato di informazioni (tipicamente le 
chiavi), ha un minore carico sulla rete e sul pro- 
cessore. Una seconda conseguenza è però la ne- 
cessità di mantenere il computer collegato alla re- 
te: contrariamente, un accesso ad informazioni 
non presenti nella memoria locale genererà un er- 
rore di comunicazione. 



ESTRARRE 

LE INFORMAZIONI 

L'oggetto BulkResponse, oltre alle informazioni ve- 
re e proprie, contiene metadati che indicano lo sta- 
to della richiesta. Ad esempio, attraverso la chia- 
mata getStatusO è possibile verificare l'esito della 
richiesta: 

if (br.getStatus() == JAXRResponse.STATUS_SUCCESS) 

L'interfaccia JAXResponse definisce, oltre agli stati 



delle risposte anche una superinterfaccia per tutte 
le risposte JAXR, BulkResponse inclusa. Per estrar- 
re le informazioni dalla BulkResponse é necessario 
utilizzare il metodo getCollectionO. Il metodo ritor- 
na una collezione Java che conterrà oggetti del ti- 
po richiesto, nel caso specifico, oggetti di tipo Or- 
ganization. 

Collection orgs = br.getCollection(); 

A questo punto l'estrazione delle informazioni si 
traduce in un esercizio di utilizzo degli iteratori di 
Java2: 

Iterator iter = orgs.iterator(); 

while (iter.hasNext()) { 

Organization org = (Organization) iter.next(); 

//■■■ 
} 

Una volta in possesso di un oggetto Organization, é 
possibile interrogarlo per ottenerne i dettagli infor- 
mativi, come ad esempio l'elenco dei servizi offer- 
ti. Questo é un esempio dell'utilità del lazy -loading: 
il caricamento di tutte le informazioni di una orga- 
nizzazione, compresi tutti i servizi e tutti i dettagli 
di tutti i servizi sarebbe stata un'operazione molto 
onerosa, senza questo meccanismo. In questo mo- 
do le prestazioni rimangono accettabilissime. L'ot- 
tenimento dei servizi avviene in modo similare a 
quanto visto per le organizzazioni: 

Collection services = org.getServices(); 

Iterator siter = services. iterator(); 

while (siter. hasNext()) { 

Service service = (Service) siter. next(); 

//■■■ 

} 

In caso di esito negativo, i problemi potrebbero es- 
sere di diversa natura. È per questo che la risposta 
BulkResponse potrebbe contenere una collezione di 
eccezioni. In questo caso é necessario estrapolarle 
singolaremente allo stesso modo utilizzato per le 
organizzazioni ed i servizi. 



CONCLUSIONI 

Sebbene le tecnologie per i registri di servizi stia- 
no guadagnando terreno, non sono ancora molto 
diffuse. SUN e SAP hanno recentemente dichiara- 
to ad una conferenza per sviluppatori come in 
realtà i loro clienti stiano sì considerando l'utiliz- 
zo di UDDI, ma più per la creazione di registri in- 
terni invece che per l'interfacciamento servizi di 
terze parti su Internet. Forse il fatto che V80% de- 
gli URL presenti nel registro UDDI mondiale è 
sbagliato (rif. TechDays 2001) è uno dei motivi. 

Massimiliano Bigatti 
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L'esperto risponde... 



Power Users 

► ► ► ► ► 

Buongiorno Ing. Florio, ogni 
tanto mi trovo "costretto" a 
chiedere qualche consiglio, ma 
proprio quando non so più che 
strada prendere (salto i meritati 
complimenti alla Sua persona e 
alla rivista); sapevo che con 
Windows 2000 Pro il gruppo 
Power Users permetteva 
l'installazione di software sul 
sistema; oggi ho creato un 
utente appartenente a questo 
gruppo e ho provato ad 
installare del software. 
Risultato: impossibile installare 
perché richiedono i privilegi di 
amministratore! 
C'è qualche maniera per 
abilitare il gruppo Power User ad 
installare software senza che 
manovre incaute possano 
danneggiare il sistema? 

Risponde Elia Florio. 

Ringrazio sentitamente per i com- 
plimenti che continuamente ricevo 
da voi lettori. 

Si, in genere questo è vero, gli utenti 
"Power Users " possono installare deter- 
minati software sul sistema operativo. 
Purtroppo ci sono installazioni ed 
installazioni... Power Users dà ad un 
utente il permesso di installare i pro- 
grammi, tuttavia se il software installa- 
to non si limita a fare le operazioni "le- 
gali", ma prova ad esempio a scrivere 
nella WINDOWS \ SYSTEM o a modifi- 
care DLL di sistema e cose di questo 
tipo, scattano le restrizioni. 
Questa limitazione è necessaria, perché 
altrimenti Power Users potrebbe in- 
stallare Trojan, Worm o potrebbe ese- 
guire quei programmi che loggano le 
password di sistema o che trasformano 
un utente generico in Administrator. 
Per abilitare il gruppo Power Users, 
senza problemi di manovre incaute, è 
necessario avere un dominio Windows 



2000 (con relativo server) sul quale im- 
postare restrizioni e permessi a gruppi 
di utenti. 



Corso Java... delucidazioni 

► ►►►►►►►►►►►►►► 

Gentile redazione, sono un 
nuovo programmatore a cui 
piace la rivista ma ho alcuni 
problemi con il corso di Java. 
Dico subito che ho esperienze 
con il C++ e questo mi ha 
permesso di capire molte cose, 
in quanto i due linguaggi di 
programmazione si somigliano 
molto. Il problema è sorto 
quando ho installato J2SE SDK 
ed ho provato a compilare ed 
eseguire la versione Java del 
programma Ciao Mondo. 
Lo javac funziona benissimo, il 
problema sorge quando cerco di 
eseguire il programma con la VM 
java.exe. Eseguendo il file 
Saluti. class il Prompt compare 
per un microsecondo e non ho il 
tempo di leggere se il 
programma è eseguito con 
successo. Può essere un 
problema dato dalla 
compatibilità con il kit Borland 
per C++ versione 3.1 o il 
problema è un'altro? Vi sarei 
grato se mi segnalereste la VM 
per eseguire codice Java in 
ambiente Linux Mandrake o 
comunque in Linux. 
Grazie e complimenti per la 
rivista. 

Matteo Liberti • Email 

Risponde Paolo Perrotta 

Ciao Matteo, la soluzione del tuo 
problema (se ho capito qual è il 
problema) è semplice: anziché eseguire 
il file con il comando "Esegui" del me- 
nu di Windows, apri una finestra del 
prompt permanente. Il modo più sem- 
plice per farlo è andare nel menu 



"Start", scegliere "Esegui" e inserire il 
comando "cmd". Si dovrebbe aprire 
una finestra del prompt, nella quale 
potrai comodamente lanciare il pro- 
gramma ed esaminarne l'output. Se il 
programma viene eseguito con succes- 
so, dovresti leggerne l'output subito 
prima del prompt successivo. Per 
quanto riguarda la VM Java per Linux, 
la trovi all'indirizzo http:/ /java .sun.com. 
Puoi scaricare l'ambiente di run-time o 
l'intero SDK per Linux. 



Spiare in Rete 

► ►►►►►►►►►►►►►► 

Buon giorno a tutti voi, 
innanzi tutto vorrei 
complimentarmi per la qualità 
della vs rivista, che compro ogni 
mese da almeno 3 anni, sempre 
chiarissima e completa nei vari 
argomenti trattati. Vorrei 
portare alla vs attenzione un 
problema che non riesco a 
risolvere a proposito dell'articolo 
"Spiare in rete" del n° 
Luglio/Agosto 2002 di Elia Florio. 
Usando il Borland C++ Builder 
anziché il VB per compilare 
l'eseguibile che accede alla DLL 
che contiene la procedura di 
Hook della tastiera, ritorna 
l'errore di "Entry point not 
found", quindi non riesce a 
trovare la funzione KeyProc. 
Devo specificare che ho fatto 
una semplice "traduzione" da VB 
a C++ utilizzando le stesse API 
usate nel programma VB e che 
la DLL l'ho generata con il 
Builder stesso. 
Il problema può nascere dal 
fatto che ho compilato la DLL 
con il Builder, o invece da 
qualche arrangiamento 
mancante nell'eseguibile vero e 
proprio?Se dovessi 
implementare un Hook per il 
Mouse, cosa dovrei cambiare? 
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Avete dei suggerimenti da 
darmi? Vi ringrazio in anticipo 
per la risposta che vorrete 
inviarmi. 

Mauro Casula 

Risponde Elia Florio 

Si tratta di un errore tipico... in prati- 
ca l'eseguibile che crei con BCC non 
riesce a trovare l'entry point della libre- 
ria DLL, cioè non riesce a localizzare il 
punto d'ingresso per una delle chiama- 
te fatte alla DLL. Deve esserci qualche 
problema nella "traduzione", magari 
un errore di ortografia nei nomi delle 
API, oppure una sciocchezza simile. 
Quando esegui il file EXE sei certo che 
la DLL si trovi nella stessa directory? Il 
codice per l'intercettazione del mouse è 
un po' diverso, nel senso che il model- 
lo di hook globale è molto simile, cam- 
biano le API che accedono al driver 
della periferica. 

Script Control 
nelle applicazioni 

► ►►►►►►►►►►►►►► 

Amici di ioProgrammo, vi 
scrivo per avere 
delucidazioni in merito allo 
sviluppo di un'applicazione che 
mi permetta di utilizzare i 
famosi linguaggi di scripting 
JavaScript e VBScript all'interno 
delle mie applicazioni Delphi. 
Sicuro di un vostro "pronto 
intervento" vi ringrazio e vi 
auguro buona continuazione di 
lavoro. 

Mauro • Email 

Gentile lettore, Microsoft ha ideato 
un insieme di interfacce COM, 
denominate ActiveScripting, per co- 
municare direttamente con un motore 
di scripting. 

Solitamente solo gli "addetti ai lavo- 
ri" più esigenti avvertono la neces- 
sità di scontrarsi con l'astrusità di 
ActiveScripting. Per implementare un 
motore di scripting basta importare, 
all'interno della nostra applicazione, 
l'oggetto Microsoft Script Control clic- 
cando sulla voce Import ActiveX Control 
del menu Component di Delphi. Sarà 
così creata la unit MSScriptControl_TLB 
nella cartella predefinita e aggiunto un 
componente alla palette. 



Un banale esempio di utilizzo del com- 
ponente TScriptControl richiede i se- 
guenti passi. 

Supponiamo di avere un main form 
con all'interno un bottone denominato 
BitBtnl e un controllo testo denominato 
MemoScript, quest'ultimo servirà all'u- 
tente per digitare lo script da mandare 
in esecuzione. 

1) Posizioniamo il componente TScript- 
Control sul form 

2) Nella procedura FormCreate stabi- 
liamo il linguaggio dello script ed 
eventuali altre proprietà: 

procedure TForml.FormCreate( 

Sender: TObject); 
begin 
// hWnd del controllo "genitore" = 

Formi. Ha nd le 
ScriptControll.SitehWnd := Self. Ha nd le; 
// Linguaggio da utilizzare = VBScript 
ScriptControll.Language := 'VBScript'; 
end; 

3) Associamo al pulsante BitBtnl il se- 
guente codice: 

procedure TForml.BitBtnlClick( 

Sender: TObject); 
begin 
ScriptControl 1 . ExecuteStatement( 

MemoScript. Text); 
end; 

Con pochissime righe di codice abbia- 
mo "creato" un interprete di codice 
VBScript/JScript , in grado di eseguire 
qualsiasi istruzione. 
L'esecuzione di interi script è un com- 
pito meno elementare perché il nome 
della funzione ed i relativi parametri 
devono essere opportunamente passati 
a ScriptControl. 



Cos'è SQLXML? 

► ►►►►►►►►►►►►►► 

Una domanda alla quale 
spero possiate dare risposta 
al più presto: di recente ho 
sentito parlare, in merito a SQL 
Server 200, di SQLXML; la cosa 
mi intriga molto, essendo uno 
sviluppatore che da poco si sta 
affacciando all'affascinante 



mondo di XML. 

Carlo Somino • Email 

L/ utilizzo di XML come standard 
per l'interscambio delle informa- 
zioni ha richiesto, e richiede ancora 
oggi, degli sforzi per creare documenti 
XML basati su dati contenuti in tabelle 
di database. Lo sforzo solitamente con- 
siste nella creazione di un traduttore 
che a partire dalle tabelle interessate, 
crei i documenti XML da usare come 
file di interscambio. Di questa neces- 
sità Microsoft ha fatto virtù, creando 
un modello di accesso ai dati comple- 
tamente basato su XML e completa- 
mente integrato in SQL 2000, ovvero 
SQLXML. Le possibilità offerte dal 
modello di accesso ai dati integrato 
SQLXML sono molteplici: 

• Accesso al motore di query di SQL 
2000 attraverso il protocollo http, 
mediante query "in-line" o median- 
te l'uso di appositi "Templates" ; 

• Estrazione diretta dei dati in forma- 
to XML nativo; 

• Estrazione e trasformazione dei 
dati XML mediante XSLT (eXtensi- 
ble Stylesheet Language Transforma- 
tions); 

• Modifica ed inserimento dati me- 
diante UpdateGrams; 

• Potente motore di Bulk-Load di dati; 
il Bulk-Load offre prestazioni supe- 
riori quando risulta necessario cari- 
care grandi quantità di dati all'in- 
terno del nostro server di database; 

• Supporto, tramite le classi managed, 
del Framework .NET; 

• Supporto dei Web Service grazie al 
SOAP Toolkit 2.0; 

• Formattazione dei risultati XML in 
modalità Client-Side o Server-Side. 
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ON LINE 

Game 

Development 
Search Engine 

Il punto di incontro per 
tutti i programmatori di 
videogame, siano essi 
aspiranti tali o provetti 
sviluppatori. Diverse le 
aree di interessate, tra 
queste citiamo: 3D e grafi- 
ca, articoli e tutorial, codi- 
ce sorgente e newsgroup. 



Comprehensive VB.NET Debugging 




Java World 

Semplicemente uno dei 
più vasti container su 
Java. Articoli, faq, libri, tip 
e quanto altro possa esse- 
re di supporto allo svilup- 
po di applicazioni. 






The Code 
Project 

Una marea di articoli per 
ogni linguaggio di pro- 
grammazione. Un sito crea- 
to dagli sviluppatori per gli 
sviluppatori. 





Compcefienstve- 

VB.NET 
Debugging 



a* 



Lo sviluppo di applicazioni, è sempre più difficile, è sovente incorrere in 
errori di progettazione che, in alcuni casi, possono rivelarsi deleteri. 
Il testo in oggetto pone l'accento sui tool di Microsoft .NET, messi a 
disposizione dello sviluppatore, per cercare di eliminare bug che, spesso e 
volentieri, rimangono "invisibili" al programmatore. 

In particolar modo si fa riferimento a quanto di buono gli sviluppatori di 
Redmond hanno implementato in Visual Basic .NET. Oltre ai tool, l'autore 
del testo in oggetto analizza anche i classici problemi di programmazione, 
mostrando, in modo molto dettagliato, tutte le fasi di debug che portano a 
"scoprire" le vulnerabilità del codice. 

Difficoltà: Medio - Alta • Autore: M.Pearce • Editore: Apress http://www.apress.com 
ISBN: 1-59059-050-3 • Anno di pubblicazione: 2003 • Lingua: Inglese • Pagine: 528 
Prezzo: $ 54.99 



MySQL 4 - Guida Completa 

MySQL è un RDBMS Open Source, quindi "libero", a detta di molti è il 

database più veloce e funzionale rispetto anche a database di categorie 

superiori. Il testo si prefigge di introdurre agli utenti questo potente sistema 

e di condurli nella realizzazione e nella gestione di un database di grandi 

dimensioni e prestazioni. Il libro tratta della versione 4.0.1, che gira sia sotto 

Linux sia sotto Windows. Destinato a chi sta cercando di sostituire il vecchio 

DB con strumenti più efficaci, a sviluppatori di siti web che si 

interfacceranno con i database, a chi usa la piattaforma Linux e ha bisogno 

di un sistema di archiviazione dati di livello aziendale e anche a chi vuole, 

comunque, imparare a usare i database relazionali. 

Difficoltà: Media • Autore: A.Butcher • Editore: Apogeo http://www.apoqeonline.com 
ISBN: 88-503-2127-9 • Anno di pubblicazione: 2003 • Lingua: Italiano • Pagine: 544 • Prezzo: € 39,00 




Hack Attacks Testing 




Un testo che può rivelarsi fondamentale per ogni amministratore di 
sistema che, ogni giorno, si trova dinanzi al problema di garantire la 
sicurezza della propria Rete. Scritto da un guru della sicurezza 
informatica, il testo mostra gran parte delle tecniche di hackeraggio che 
possono compromettere la vulnerabilità del sistema, altresì viene mostrato 
come difendersi da tali attacchi, analizzando passo passo diverse strategie. 
Da segnalare: 

• Installazione e configurazione "sicura" di Windows 2000 Server, Linux, 
Solaris, Mac OS X. 

• ISS, CyberCop, Nessus, SAINT, e STAT scanner. 

• Diversi tool di analisi per testare la sicurezza del proprio sistema 
operativo. 

Il CD-Rom allegato al testo contiene una simulazione di scanner alla 
ricerca di possibili vulnerabilità, una versione evaluation di ISS Internet 
Scanner e diverse altre utilità. 

Difficoltà: Media • Autore: J. Chinilo • Editore: Wiley http://www.wileyeurope.com 
ISBN: 0-471-22946-6 • Anno di pubblicazione: 2003 • Lingua: Italiano • Pagine: 560 
Prezzo: € 47.70 • Contiene 1 CD-Rom 
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